Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Vacms 15315 front end match style to sketch, testing #1790

Conversation

eselkin
Copy link
Contributor

@eselkin eselkin commented Nov 13, 2023

Summary

  • Use va-link, va-telephone, create spotlight content to use url vs uri in vet center, etc
  • Testing for liquid filters added
  • Facilities
  • No flipper

Related issue(s)

Testing done

  • This is branched off va-14940... which has the skeleton of the VBA facility in its initial form
  • Testing was added to 3 filters

Screenshots

see: https://web-w1a5evfuonymjntciz3pduj1ofhepwky.demo.cms.va.gov/vba-facilities/locations/seattle-regional-office/

screencapture-web-w1a5evfuonymjntciz3pduj1ofhepwky-demo-cms-va-gov-vba-facilities-locations-seattle-regional-office-2023-11-20-13_22_28

What areas of the site does it impact?

Solely VBA, conditionals were added to existing liquid templates used in other areas to only display certain aspects when VBA variables are set. Many of the conditionals already existed and were just expanded upon.

Acceptance criteria

Quality Assurance & Testing

  • I fixed|updated|added unit tests and integration tests for each feature (added 3 unit tests with two tests each).
  • No sensitive information (i.e. PII/credentials/internal URLs/etc.) is captured in logging, hardcoded, or specs
  • Linting warnings have been addressed
  • Documentation has been updated (link to documentation *if necessary)
  • Screenshot of the developed feature is added
  • Accessibility testing has been performed

Error Handling

  • Browser console contains no warnings or errors.
  • Events are being sent to the appropriate logging solution
  • Feature/bug has a monitor built into Datadog or Grafana (not applicable)

Authentication

  • Did you login to a local build and verify all authenticated routes work as expected with a test user

Requested Feedback

@eselkin eselkin changed the title Vacms 15315 front end match style testing Vacms 15315 front end match style to sketch, testing Nov 13, 2023
@va-vfs-bot va-vfs-bot temporarily deployed to master/main/VACMS-15315-front-end-match-style-testing November 13, 2023 23:46 Inactive
Copy link
Contributor

@maxx1128 maxx1128 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I looked through the code again and found some small HTML errors that should be corrected.

src/site/layouts/vba_facility.drupal.liquid Outdated Show resolved Hide resolved
src/site/layouts/vba_facility.drupal.liquid Show resolved Hide resolved
src/site/layouts/vba_facility.drupal.liquid Show resolved Hide resolved
href="tel:{{ fieldPhoneNumber }}">{{ fieldPhoneNumber }}</a>
</div>
{% endif %}
{% if fieldRegionPage.entity.fieldVaHealthConnectPhone %}
<div class="vads-u-margin-bottom--1">
Copy link
Contributor

@maxx1128 maxx1128 Nov 14, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Issue: this should be a <p> tag.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

None of the other templates have the telephone sections in p tags, just divs. Are we sure we want <p> tags?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking at it on a live page, any <strong> and <a> tags are meant to be inside of a <p> tag. Otherwise, we have text inside a <div> tag, which has no semantic meaning. It will need to add the vads-u-margin-top--0 class to remove the extra top margin, but otherwise, it should look the same to visual users.

As for the other templates not using it, that may need to be a follow-up ticket to address it in other areas better. But we should probably (a)sync with @laflannery on it first.

Screen Shot 2023-11-15 at 11 03 18 AM

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@maxx1128 and @eselkin Couple questions:

  1. Are we using the <va-telephone> component on the new VBA page?
  2. I know we aren't currently using the component in other places, it's something we need to work on updating so I think this would be good to roll into one ticket. To clarify the new ticket should be to update phone number markup within other facility templates to look like this correct?
    image

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@laflannery

  1. Yes, this page uses the <va-telephone> component.
  2. It's not a requirement to have anchor tags in paragraph tags, but it is preferred since it makes more semantic sense for an anchor tag to be in a larger text element, like a paragraph tag. The paragraph tag would need the vads-u-margin-top--0 class, which should be the same visually. I can also do a little extra research and testing on this.

Copy link
Contributor Author

@eselkin eselkin Nov 16, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@maxx1128 Make sure to take a look at https://web-w1a5evfuonymjntciz3pduj1ofhepwky.demo.cms.va.gov/vba-facilities/locations/seattle-regional-office/

I think the screenshot was of a different tugboat environment or something because it didn't have the va-telephone.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@eselkin I see the <p> but the class didn't get added correctly, it's missing the =:
image

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@eselkin I tried adding the <p> tag locally and saw that our stylesheet added some top margin to them. Removing the top margin just keeps it more consistent with the styles we currently have for the phone numbers.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@eselkin I see the <p> but the class didn't get added correctly, it's missing the =: image

That is so weird... I'm rebuilding, locally and in github they have the equal and the right quotation marks.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The rebuild fixed the odd quotes and equal sign it seemed. Not sure how that happened.

@va-vfs-bot va-vfs-bot temporarily deployed to master/main/VACMS-15315-front-end-match-style-testing November 14, 2023 22:28 Inactive
@va-vfs-bot va-vfs-bot temporarily deployed to master/main/VACMS-15315-front-end-match-style-testing November 14, 2023 23:03 Inactive
pjhill and others added 4 commits November 15, 2023 07:16
Bumps [actions/checkout](https://github.com/actions/checkout) from 3.5.2 to 4.1.1.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@8e5e7e5...b4ffde6)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
@va-vfs-bot va-vfs-bot temporarily deployed to master/main/VACMS-15315-front-end-match-style-testing November 15, 2023 23:44 Inactive
@va-vfs-bot va-vfs-bot temporarily deployed to master/main/VACMS-15315-front-end-match-style-testing November 16, 2023 00:00 Inactive
@va-vfs-bot va-vfs-bot temporarily deployed to master/main/VACMS-15315-front-end-match-style-testing November 16, 2023 03:03 Inactive
@laflannery
Copy link

@eselkin and @maxx1128 I reviewed the page linked above (which may or may not have been ready?) but there are some questions/comments below:

  1. Breadcrumbs aren't currently using the <va-breadcrumbs> component. I know we had talked about this in slack so it may just be in a branch that is not this one. Also, can we make sure to use the v3 component if it is determined that is possible?
    image
  2. The "Hours" heading says "Office hours" in the Sketch file. Is that just a difference in Drupal content or is that something we should fix here?
    image
  3. Back to top should use <va-back-to-top> component
  4. <va-aler> component should use v3 (assuming we can?)
    1. It also has an extra, empty <p> tag
      image
  5. The directions link is not using the <va-link> component. I wasn't sure if it was possible to use the component and also do all the things we needed to do (open in a new tab, use the sr-only pattern, etc.). I just want to confirm that is why we aren't using the component here.
  6. I found an empty <nav> element, are we able to get rid of this? It's bad for screen reader users (I realized my screen shot does not give much context, it's above the H1)
    image
  7. The 3 secondary top task links also do not match sketch (the text and the links themselves). Is this also something we should change at this stage?
    image

@maxx1128 maxx1128 force-pushed the va-14940-vba-facility-content-skeleton branch from c00627d to 77649de Compare November 16, 2023 17:24
@va-vfs-bot va-vfs-bot temporarily deployed to master/main/VACMS-15315-front-end-match-style-testing November 20, 2023 18:28 Inactive
@eselkin eselkin marked this pull request as ready for review November 20, 2023 20:38
@eselkin eselkin requested review from a team as code owners November 20, 2023 20:38
@va-vfs-bot va-vfs-bot requested a review from a team November 20, 2023 20:38
Copy link
Collaborator

@va-vfs-bot va-vfs-bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Icon found

Icons can be decorative, but sometimes they are used to convey meaning. If there are any semantics associated with an icon, those semantics should also be conveyed to a screen reader.

What you can do

Review the markup and see if the icon provides information that isn't represented textually, or wait for a VSP review.

<div class="social-links-email vads-u-margin-bottom--2">
<a class="vads-u-display--flex vads-u-align-items--baseline vads-u-text-decoration--none" rel="noreferrer"
href="{{fieldNews.uri}}">
<i class="fas fa-envelope vads-u-margin-right--1"></i>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

icon found

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@laflannery since we're using raw anchor tags here, is there some description about how these should be conveyed textually?

{% if fieldFacebook != empty %}
<div class="social-links social-links-facebook vads-u-margin-bottom--2">
<a class="vads-u-display--flex vads-u-align-items--baseline vads-u-text-decoration--none" rel="noreferrer" href="{{ fieldFacebook.uri }}">
<i class="fab fa-facebook-square vads-u-margin-right--1"></i>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

icon found

{% if fieldTwitter != empty %}
<div class="social-links social-links-twitter vads-u-margin-bottom--2">
<a class="vads-u-display--flex vads-u-align-items--baseline vads-u-text-decoration--none" rel="noreferrer" href="{{ fieldTwitter.uri }}">
<i class="fab fa-twitter vads-u-text-decoration--none vads-u-margin-right--1"></i>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

icon found

{% if fieldFlickr != empty %}
<div class="social-links social-links-flickr vads-u-margin-bottom--2">
<a class="vads-u-display--flex vads-u-align-items--baseline vads-u-text-decoration--none" rel="noreferrer" href="{{ fieldFlickr.uri }}">
<i class="fab fa-flickr vads-u-text-decoration--none vads-u-margin-right--1"></i>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

icon found

{% if fieldInstagram != empty %}
<div class="social-links social-links-instagram vads-u-margin-bottom--2">
<a class="vads-u-display--flex vads-u-align-items--baseline vads-u-text-decoration--none" rel="noreferrer" href="{{ fieldInstagram.uri }}">
<i class="fab fa-instagram vads-u-text-decoration--none vads-u-margin-right--1"></i>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

icon found

{% if fieldYoutube != empty %}
<div class="social-links social-links-youtube vads-u-margin-bottom--2">
<a class="vads-u-display--flex vads-u-align-items--baseline vads-u-text-decoration--none" rel="noreferrer" href="{{ fieldYoutube.uri }}">
<i class="fab fa-youtube vads-u-text-decoration--none vads-u-margin-right--1"></i>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

icon found

<div class="vads-u-padding-top--1">
<p>
<a class="vads-u-display--block" href="{{ entity.fieldCta.entity.fieldButtonLink.url }}" >
<span> {{ entity.fieldCta.entity.fieldButtonLabel }} <i class="fa fa-chevron-right vads-facility-hub-cta-arrow" aria-hidden="true"></i></span>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

icon found

@va-vfs-bot va-vfs-bot temporarily deployed to master/main/VACMS-15315-front-end-match-style-testing November 20, 2023 21:02 Inactive
@eselkin
Copy link
Contributor Author

eselkin commented Nov 20, 2023

@laflannery

  1. v3 Not yet on the most recent tugboat - so I wonder if this means we can't use v3 components?
    It's odd though, if you remove the attribute "uswds" from the va-alert on the page then the component does change.
  1. Not yet updated on the most recent tugboat but I know you got your answers so I'm not super concerned about these

Should be there now! Sorry about missing that.

  1. I answered your comments in the Sketch - take a look there for more detailed info. The short answer though is the heading for "Get Updates" definitely needs to be a semantic H2

Keeping as H2

@va-vfs-bot va-vfs-bot temporarily deployed to master/main/VACMS-15315-front-end-match-style-testing November 20, 2023 23:42 Inactive
@va-vfs-bot va-vfs-bot temporarily deployed to master/main/VACMS-15315-front-end-match-style-testing November 20, 2023 23:51 Inactive
@davidmpickett
Copy link
Contributor

@davidmpickett The sketch comment says for "make an appointment" to link to: https://va.my.site.com/VAVERA/s/ But normally for make an appointment we link to: va.gov/somecenter/make-an-appointment The "my.site.com" one sounds a little odd. If it is the my.site.com one, should we have it link to a "blank" target and rel="noreferrer"?

That is indeed the correct URL. VBA uses an entirely different scheduling tool than VAMCs. I defer to @laflannery on whether this would be an exception to the normal external link guidance. We might also need to have CAIA re-review this specific instance and reword it. @xiongjaneg

@laflannery
Copy link

laflannery commented Nov 21, 2023

@eselkin:
4. You are 100% correct, this is using the v3 component. The bookmarklet I was using to look at these wasn't configured right. We are good to go!
7. You also got these all correct regarding the internal/external behavior. I do agree that CAIA should confirm because the external link guidance is a bit unfinished.

  • However the href for the 3rd link (Check claim status) needs to be updated. It should be /claim-or-appeal-status/ rather than /vba-facilities/claim-or-appeal-status

@xiongjaneg
Copy link

RE: https://va.my.site.com/VAVERA/s/ being an external link

Michelle verified that is the only appointment link used for VBA. I can't speak to internal/external link guidance, but there is no other link to provide for VBA appointments. It is the VA appointment tool for VBA.

@eselkin
Copy link
Contributor Author

eselkin commented Nov 21, 2023

@laflannery

  • However the href for the 3rd link (Check claim status) needs to be updated. It should be /claim-or-appeal-status/ rather than /vba-facilities/claim-or-appeal-status

I updated in the code, it didn't make it to the tugboat

@eselkin eselkin merged commit 9d61d0b into va-14940-vba-facility-content-skeleton Nov 21, 2023
18 checks passed
@eselkin eselkin deleted the VACMS-15315-front-end-match-style-testing branch November 21, 2023 18:38
jilladams pushed a commit that referenced this pull request Nov 27, 2023
…for VBA (#1762)

* VA-14940: Update VBA Facility Query

* VA-14940: Add VBA Facility to larger build processes

* VA-14940: Update VBA Facility skeleton template

* remove NearbyVetCenters widget after discussion and update link to find-locations

* VA-14940: Update VBA Facility Query

* VA-14940: Add VBA Facility to larger build processes

* VA-14940: Update VBA Facility skeleton template

* remove NearbyVetCenters widget after discussion and update link to find-locations

* VA-14940: Remove unused VBA Facility query field

* Vacms 15315 front end match style to sketch, testing (#1790)

* working va-telephone components, cc benefits hotline, cc cannot find benefits
* back to top and above footer
* describe structure of processed better
* Add breadcrumb data and update component
* p tags with margin top 0
* uswds on alert, office hours, etc
* social updates
* vba links at top
* testing for updates filters
* fix mock data
* claim status link
----
Co-authored-by: Max Antonucci <[email protected]>
Co-authored-by: Nate Douglas <[email protected]>

---------

Co-authored-by: Eli Selkin <[email protected]>
Co-authored-by: Eli Selkin <[email protected]>
@davidmpickett
Copy link
Contributor

davidmpickett commented Nov 29, 2023

This includes the social links. Warning, the centralized content for those links is wrong, and I think they need to keep the titles to what they have in the sketch.

The centralized content is also weird for that info alert with the extra <p> that I can't edit, but I can't touch any centralized content.

Good catches, @eselkin. I just removed the extraneous <p> tag
and will work on getting the social links updated. There is actually an unresolved comment thread with CAIA about the wording of those that I will resurface

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.