Documentation

Usability

When to use

When the number of results are relevant to explain to the user the relative success of their query.

When not to use

When there are no results (see "No results found").

Documentation

Guidelines

Do not show search controls or pagination when no results are displayed.

Usability

When to use

When zero results are returned by the user's query.

Documentation

Accessibility

The previous and next buttons are hidden with aria-hidden when they are non-functional.

Implementation

Below the M breakpoint (600px) the pagination is represented by the next and/or previous buttons.
Above the M breakpoint there are several rules:
- The first and last page links are always displayed.
- Current page number is always displayed with +/- 1 page to either side.
- When displaying the first and last pages +/- 2 pages are displayed.
- When displaying the first page the Previous button is not displayed.
- When displaying the last page the Next button is not displayed.
- There are only ever 5 page links displayed, including first and last page. All other pages are abbreviated into ellipses.
Pagination should always be shown at the bottom of the page, near the bottom of the list that it paginates.

Usability

When to use

When it is not feasible to show all ordered data on a single page.

Do not use when

When it is undesirable to have the user pause for navigation. Some alternatives include the infinite scroll pattern or simple un-numbered navigation.

Documentation

Requirements

The search card component MUST include the following:

Position title
- display position title as a link that opens the job posting (job announcement) in the same window.
- on click, change the link to visit link state (purple link).
  - MUST remain in this state for the entire session.
  - MUST remain in this state even when the user signs out and signs back in.
Agency name
Department name
Location
Starting salary & matching starting-ending pay schedule (example: GS13-14)
Appointment type (formerly known as work type)
Work schedule
Hiring paths icons
The label/description is shown on the hover state
Opening and closing period
Save/saved star trigger
- Only show to signed-in users
- Display as a link that will allow users to save and un-save a job posting.
- Follow the save/saved star trigger guidelines.
- Do NOT display the save/saved star trigger to signed-out users.

The search card component MAY include the following:

Application status: If the user has a started or finished an application to this job then the application status should appear. The same state names and colors as appear for application status in the profile dashboard should be employed.

When to use

To represent a job announcement in a list of announcements.

Documentation

When to use

To represent a job announcement an a Mission Critical Occupation page.
THIS VARIATION IS TO BE REPLACED BY THE STANDARD CORE VARIATION ABOVE.

Documentation

When to use

To represent a job announcement in the recruitment tool.

Documentation

When to use

To represent an opportunity in Open Opportunitites.

Documentation

Guidelines

The teaser, when it appears, should appear between the 5th and 6th job result. Ideally it would be loaded via an asynchronous request after results are displayed so that it does not negatively impact search performance.
Only one teaser should be shown in one set of search results. Currently there is overlap in triggering keywords thus a round robin mechanism should be deployed to rotate between the overlapping teasers. There is also the possibility of overlap in the use of filters. In this case the keyword trigger should win out.
Links that leave the usajobs.gov domain should open in a new tab.

When to use

Each teaser appears in search results IF and only if they are relevant to the search. Relevance is defined by keyword for these variants excluding the Event variation which is dependent upon location and/or hiring path.
Events:
1. Location: A matching event should appear when the location entered into the Location search field and selected from autocomplete matches the location of the event.
2. Future enhancement - Hiring path: A matching event should appear when the hiring path filter selected matches one or more of the hiring paths attached to an event.

When teasers appear

Teasers should appear as long as the criteria below are met. Their appearance is not based on a session given that these are not currently popular queries.
Keywords: When the user enters this string into the keyword field the appropriate teaser should appear in their search results.
Occupations: When the user enters this string into the keyword field AND selects the matching occupation from autocomplete the appropriate teaser should appear in their search results.
Department/Agency: When the user enters this string into the keyword field AND selects the matching department or agency from autocomplete the appropriate teaser should appear in their search results.

Data Science: Keywords

data
dmat

Data Science: Occupations

Bioinformatics Scientists
Bioinformatics Technicians
Business Intelligence Specialist
Computer and Information Research Scientists
Computer and Information System Managers
Data Analyst
Data Engineer
Data Warehousing Specialists
Economic Research Analysts
Enterprise Data Manager
Health Data Analyst
Information Technology Specialist (IT Specialist)
Management Analysts
Mathematical Technicians
Operations Research Analysts
Policy Advisor
Procurement Analyst
Public Health Analyst
Research Analyst
Research Assistants, Social Science
Senior Data Analyst/Programmer
Statistical Assistants

Data Science: Departments & Agencies

Department of Homeland Security (DHS)
National Security Agency (NSA)

Cyber Security: Keywords

Chief Operating Officer
cyber
Deputy Chief Information Security Officer
federal protective service
Foreign Service Office Management Specialist
Forensic Computer Analyst
fps
homeland
informatics
information
infosec
it
Performance Analyst
Policy Brand Chief
security
Supervisory Management And Program Analyst
technology
Telecommunications Specialist

Cyber Security: Occupations

Computer Network Support Specialists
Computer and Information Systems Manager
Computer Systems Analysts
Criminal Investigators and Special Agents
Information Security Analysts
Network and Computer Systems Administrators
Police Detectives
Police Identification and Records Officers
Security Management Specialists

Cyber Security: Departments & Agencies

Department of Homeland Security (DHS)
National Security Agency (NSA)

Privacy: Keywords

administrative law judge
ASSISTANT COUNSEL
Associate Chief Information Officer
attorney
CH OF CYBER & ENTERPRISE OPS
claims
counsel
cyber
data privacy
Deputy Chief Information Officer
foia
health insurance specialist
informatics
information
infosec
inspector
it specialist
j.d.
judge
law
oig
physical security
privacy
security
social insurance specialist
Supervisory IT Specialist (PLCYPLN)
SUPV IT SPECIALIST (NETWORK/CUSTSPT)

Privacy: Departments & Agencies

National Security Agency (NSA)

Controls

Results found

Viewing 1-10 of 1,562 jobs

Usability

When to use

When not to use

No results found

Please refine your search

Guidelines

Usability

When to use

Pagination

First page

Inner page

Last page

Accessibility

Implementation

Usability

When to use

Do not use when

Results

Core variation

Requirements

When to use

Mission Critical Occupation variation

When to use

Agency Talent Portal variation

When to use

Opportunity variation

When to use

Teasers

Data Science variation

Explore a career in data science.

Cyber Security variation

Explore a career in cyber security.

Privacy variation

Help protect privacy rights

Event variation

Guidelines

When to use

When teasers appear

Data Science: Keywords

Data Science: Occupations

Data Science: Departments & Agencies

Cyber Security: Keywords

Cyber Security: Occupations

Cyber Security: Departments & Agencies

Privacy: Keywords

Privacy: Departments & Agencies