Build new Facility Locator search by state results

xiongjaneg commented 1 year ago

User Story or Problem Statement

As a Veteran, I want to be able to find VA locations in my state.

Final designs

https://www.sketch.com/s/d5e5c924-e8c0-47af-b3e4-994c335d6f31

Description or Additional Context

Facility Locator will be updated to search by state.

Currently, under the map, there is a link: Can’t find what you’re looking for? Try using our other tools to search. This links to a state by state listing of all VA facility types.

The updated search will include a link under the map that goes to a new search by state page that includes state and facility type.

This front end of this new page can be built as hard coded lorem if API work needs to be done in #14915 first, before connecting the data to this front end.

Acceptance Criteria

[ ] Results are displayed
[ ] Page uses CAIA-approved path (TBD, based on CAIA intake/IA ticket)
[ ] Requires design review
[ ] Requires accessibility review

mmiddaugh commented 1 year ago

Suggestions for functional behavior acceptance criteria (not sure if they belong here or https://github.com/department-of-veterans-affairs/va.gov-cms/issues/14916 - please adjust as needed)

Search parameters persist in search fields after search results are presented
Veterans understand the total number of search results and the number which are displayed on the current page, similar to main Facility Locator behavior
Search results are presented in the sort order specified. (Pending design input)
Search results can be navigated using keyboard only.
A Veteran using a screen reader or magnification is made aware when results appear.
A Veteran using a screen reader or magnification is made aware of the number of results.
Veterans can move between pages of search results.
Veterans can return to the main Facility Locator search experience or use other tools to search. (Pending design input)
Review and sign-off by Design, A11y, PM, and PO

@thejordanwood @davidmpickett

Questions about the "Search results list for the "Browse VA locations in each state" search experience

What is the expected sort order for search results?
Do we need to provide a way for the Veteran to return to the main Facility Locator search experience?

thejordanwood commented 1 year ago

@mmiddaugh

What is the expected sort order for search results?

I think we should sort these alphabetically and have 10 results per page. The current Facility Locator search lists 10 per page, so we can keep these consistent.

Do we need to provide a way for the Veteran to return to the main Facility Locator search experience?

In my current mockups, there is a breadcrumb that will take users back to the Facility Locator search. On the state search page, the link at the bottom will change from "Browse VA locations in each state" (linking to state search) to "Browse VA locations near you" (linking back to Facility Locator).

If we want to make the link more obvious, we can put one in the copy under the "Browse Va locations in each state" header.

mmiddaugh commented 1 year ago

@xiongjaneg we will want to ensure the new functionality is wired for analytics - should this be a separate issue?

department-of-veterans-affairs / va.gov-cms