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

Editor-centered management for Veteran-centered content.
https://prod.cms.va.gov
GNU General Public License v2.0
96 stars 70 forks source link

Resources & Support: upgrade to va-icon #17817

Closed randimays closed 3 months ago

randimays commented 4 months ago

Description

The Design System team is deprecating Font Awesome and encouraging teams to use <va-icon> where possible by the end of May 2024. Slack post here: https://dsva.slack.com/archives/C03R5SBELQM/p1710776364414359

We need to convert all usage of <i> in this application in vets-website and content-build to <va-icon> to align with the icons in DST's library here: https://design.va.gov/foundation/icons

<va-icon> guidance in Storybook: https://design.va.gov/storybook/?path=/docs/uswds-va-icon--default

Engineering notes

Icons to be converted:

  1. https://github.com/department-of-veterans-affairs/vets-website/blob/17621d7d0b4c4a3df774bd3a742aeda72cdae797/src/applications/resources-and-support/components/SearchBar.jsx#L128
  2. https://github.com/department-of-veterans-affairs/vets-website/blob/17621d7d0b4c4a3df774bd3a742aeda72cdae797/src/applications/resources-and-support/components/SearchBar.jsx#L135
  3. https://github.com/department-of-veterans-affairs/content-build/blob/267e8c01b81d33570a2d97cf9f71e93b23f996fb/src/site/components/browse-by-audience.drupal.liquid#L33
  4. https://github.com/department-of-veterans-affairs/content-build/blob/267e8c01b81d33570a2d97cf9f71e93b23f996fb/src/site/paragraphs/lists_of_links.drupal.liquid#L26
  5. https://github.com/department-of-veterans-affairs/content-build/blob/267e8c01b81d33570a2d97cf9f71e93b23f996fb/src/site/layouts/media_list_images.drupal.liquid#L82

User story

AS A PO/PM for products/features/applications managed by the Public Websites team I WANT our features/products/applicates migrated to va-icon where appropriate SO THAT when the migration to va-icon and deprecation of Font Awesome takes place, there won't be degraded Veteran-facing experiences in VA.gov.

Quality / testing notes

Acceptance criteria

randimays commented 4 months ago

Mid-sprint update: we have been blocked on using va-icon in content-build since 4/19. DST is still working on a fix; it's not clear whether it will be released before the end of our sprint, but flagging the risk here.

randimays commented 3 months ago

@thejordanwood The slider icon for mobile Resources & Support search does not seem to have an equivalent in USWDS (https://designsystem.digital.gov/components/icon/). Is there an icon there that you think would fit with this interface? Also including the open version of this widget for reference.

Screenshot 2024-05-13 at 4 52 57 PM Screenshot 2024-05-13 at 4 53 01 PM

We could move to an expand/collapse icon set?

Screenshot 2024-05-13 at 4 55 37 PM
thejordanwood commented 3 months ago

I think we should align with the accordion design and use the subtract and remove icons.

@aklausmeier I want to double check with you on this one since there are a couple of different options we can use, like the expand less/more icons that Randi suggested.

aklausmeier commented 3 months ago

Agree with Jordan, let's use the add and subtract USWDS icons.

randimays commented 3 months ago

Thanks @thejordanwood and @aklausmeier!

randimays commented 3 months ago

Still iterating on design & accessibility feedback for these icons. This will carry over.

laflannery commented 3 months ago

@randimays I think this is already in Prod - can that be true? I encountered it when I was doing my a11y audit of Resources & Support

randimays commented 3 months ago

@laflannery The vets-website piece of this is already in prod (that's the mobile expand/collapse behavior). The content-build piece (PR here: https://github.com/department-of-veterans-affairs/content-build/pull/2086) has not made it there yet.

randimays commented 3 months ago

The content-build piece has been validated in production. We cannot verify the browse-by-audience and media_list_images changes in production as we do not have production usage of them but we have high confidence in their usage / no regression. Closing!