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

VAGOV-TEAM-97922: Adds sidebar placeholder #20155

Merged
merged 2 commits into from
Jan 6, 2025

Conversation

ryguyk
Copy link
Contributor

@ryguyk ryguyk commented Dec 22, 2024

Description

Adds a sidebar with placeholder content to all Form Builder pages.

Relates to department-of-veterans-affairs/va.gov-team#97922

Testing done

  • Unit test updated to ensure presence of sidebar.
  • Manual tests to ensure sidebar is present.

Screenshots

image

QA steps

  1. Navigate to /form-builder/intro
    • Ensure sidebar placeholder is present
  2. Navigate to /form-builder/start-conversion
    • Ensure sidebar placeholder is present

Definition of Done

  • Documentation has been updated, if applicable.
  • Tests have been added if necessary.
  • Automated tests have passed.
  • Code Quality Tests have passed.
  • Acceptance Criteria in related issue are met.
  • Manual Code Review Approved.
  • If there are field changes, front end output has been thoroughly checked.

Select Team for PR review

  • CMS Team
  • Public websites
  • Facilities
  • User support
  • Accelerated Publishing
  • Form Engine

Is this PR blocked by another PR?

  • DO NOT MERGE

Does this PR need review from a Product Owner

  • Needs PO review

CMS user-facing announcement

Is an announcement needed to let editors know of this change?

  • Yes, and it's written in issue ____ and queued for publication.
    • Merge and ping the UX writer so they are ready to publish after deployment
  • Yes, but it hasn't yet been written
    • Don't merge yet -- ping the UX writer to write and queue content
  • No announcement is needed for this code change.
    • Merge & carry on unburdened by announcements

@ryguyk ryguyk requested a review from a team as a code owner December 22, 2024 14:57
@va-cms-bot va-cms-bot temporarily deployed to Tugboat December 22, 2024 14:57 Destroyed
@ryguyk ryguyk requested a review from derekhouck December 22, 2024 14:58
Copy link

Checking composer.lock changes...

@github-actions github-actions bot added the DO NOT MERGE Do not merge this PR label Dec 22, 2024
@va-cms-bot va-cms-bot temporarily deployed to Tugboat December 23, 2024 08:46 Destroyed
Copy link
Contributor

@derekhouck derekhouck left a comment

Choose a reason for hiding this comment

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

Screenshot 2024-12-23 at 9 18 21 AM

How much effort would it take to have the sidebar drop below the main content at a certain width? I know we don't have official responsive designs, but my initial impression is that this is a relatively minor lift that gets us a major usability gain at lower browser widths.

@va-cms-bot va-cms-bot temporarily deployed to Tugboat December 24, 2024 08:47 Destroyed
@va-cms-bot va-cms-bot temporarily deployed to Tugboat December 25, 2024 08:46 Destroyed
@va-cms-bot va-cms-bot temporarily deployed to Tugboat December 26, 2024 08:45 Destroyed
@va-cms-bot va-cms-bot temporarily deployed to Tugboat December 27, 2024 08:43 Destroyed
@va-cms-bot va-cms-bot temporarily deployed to Tugboat December 28, 2024 08:45 Destroyed
@va-cms-bot va-cms-bot temporarily deployed to Tugboat December 29, 2024 08:45 Destroyed
@va-cms-bot va-cms-bot temporarily deployed to Tugboat December 30, 2024 08:45 Destroyed
@va-cms-bot va-cms-bot temporarily deployed to Tugboat December 31, 2024 08:44 Destroyed
@ryguyk
Copy link
Contributor Author

ryguyk commented Dec 31, 2024

How much effort would it take to have the sidebar drop below the main content at a certain width? I know we don't have official responsive designs, but my initial impression is that this is a relatively minor lift that gets us a major usability gain at lower browser widths.

I specifically asked about this in one of our meetings and my takeaway was that we're not even going to spend time considering responsiveness. I agree with you that some small effort could result in some sort of improved behavior, but part of my takeaway was that we don't even know what that improved behavior should be. The sidebar dropping below the main content feels questionably useful to me.

I'm happy to do something, but I guess I need to know for sure what that something should be.

@derekhouck
Copy link
Contributor

I'm happy to do something, but I guess I need to know for sure what that something should be.

While I'm happy to make decisions now and ask forgiveness later, it's probably prudent to let it be at the moment until we have direction from Design.

derekhouck
derekhouck previously approved these changes Dec 31, 2024
@va-cms-bot va-cms-bot temporarily deployed to Tugboat December 31, 2024 17:45 Destroyed
Copy link

Checking composer.lock changes...

derekhouck
derekhouck previously approved these changes Dec 31, 2024
@ryguyk
Copy link
Contributor Author

ryguyk commented Dec 31, 2024

Updated to give left column a min-width.

@va-cms-bot va-cms-bot temporarily deployed to Tugboat January 1, 2025 08:44 Destroyed
@va-cms-bot va-cms-bot temporarily deployed to Tugboat January 2, 2025 08:45 Destroyed
@va-cms-bot va-cms-bot temporarily deployed to Tugboat January 3, 2025 08:42 Destroyed
@va-cms-bot va-cms-bot temporarily deployed to Tugboat January 4, 2025 08:49 Destroyed
@va-cms-bot va-cms-bot temporarily deployed to Tugboat January 5, 2025 08:46 Destroyed
@va-cms-bot va-cms-bot temporarily deployed to Tugboat January 6, 2025 08:45 Destroyed
@ryguyk ryguyk removed the DO NOT MERGE Do not merge this PR label Jan 6, 2025
@ryguyk ryguyk force-pushed the VAGOV-TEAM-97922-sidebar-placeholder branch from 937141b to 39d1d06 Compare January 6, 2025 16:45
@va-cms-bot va-cms-bot temporarily deployed to Tugboat January 6, 2025 16:45 Destroyed
Copy link

github-actions bot commented Jan 6, 2025

Checking composer.lock changes...

@ryguyk ryguyk force-pushed the VAGOV-TEAM-97922-sidebar-placeholder branch from 39d1d06 to 10820f6 Compare January 6, 2025 19:07
@va-cms-bot va-cms-bot temporarily deployed to Tugboat January 6, 2025 19:07 Destroyed
Copy link

github-actions bot commented Jan 6, 2025

Checking composer.lock changes...

@ryguyk ryguyk force-pushed the VAGOV-TEAM-97922-sidebar-placeholder branch from 10820f6 to 84476db Compare January 6, 2025 20:22
@va-cms-bot va-cms-bot temporarily deployed to Tugboat January 6, 2025 20:22 Destroyed
Copy link

github-actions bot commented Jan 6, 2025

Checking composer.lock changes...

@va-cms-bot
Copy link
Collaborator

Cypress Accessibility Violations

/test-data-quia

ID: button-name
Impact: critical
Tags: cat.name-role-value, wcag2a, wcag412, section508, section508.22.a, TTv5, TT6.a, EN-301-549, EN-9.4.1.2, ACT
Description: Ensure buttons have discernible text
Help: Buttons must have discernible text
Nodes:

  • HTML: <button class="proofing-element-help" role="tooltip" data-proofing-help-title="About 'Page introduction' field" data-proofing-help="Add an introduction that helps visitors understand if information on the page is relevant to them."> <span aria-hidden="true">i</span> </button>
    Impact: critical
    Target: .field--name-field-intro-text-limited-html > .field__label > .proofing-element-help[role="tooltip"]
    Summary: Fix any of the following:
    Element does not have inner text that is visible to screen readers
    aria-label attribute does not exist or is empty
    aria-labelledby attribute does not exist, references elements that do not exist or references elements that are empty
    Element has no title attribute
    Element does not have an implicit (wrapped) <label>
    Element does not have an explicit <label>
    Element's default semantics were not overridden with role="none" or role="presentation"

  • HTML: <button class="proofing-element-help" role="tooltip" data-proofing-help-title="About 'Generate a table of contents from major headings' field" data-proofing-help="By checking this box, all h2's below this point on the page will be linked with with anchor links. This helps users navigate content on very long pages. Do not check this box unless there is at least 2 h2's on the page.">
    Impact: critical
    Target: .field--name-field-table-of-contents-boolean > .field__label > .proofing-element-help[role="tooltip"]
    Summary: Fix any of the following:
    Element does not have inner text that is visible to screen readers
    aria-label attribute does not exist or is empty
    aria-labelledby attribute does not exist, references elements that do not exist or references elements that are empty
    Element has no title attribute
    Element does not have an implicit (wrapped) <label>
    Element does not have an explicit <label>
    Element's default semantics were not overridden with role="none" or role="presentation"

  • HTML: <button class="proofing-element-help" role="tooltip" data-proofing-help-title="About 'Main content' field" data-proofing-help="The main body of the page, which appears below the featured content."> <span aria-hidden="true">i</span> </button>
    Impact: critical
    Target: button[data-proofing-help-title="About 'Main content' field"]
    Summary: Fix any of the following:
    Element does not have inner text that is visible to screen readers
    aria-label attribute does not exist or is empty
    aria-labelledby attribute does not exist, references elements that do not exist or references elements that are empty
    Element has no title attribute
    Element does not have an implicit (wrapped) <label>
    Element does not have an explicit <label>
    Element's default semantics were not overridden with role="none" or role="presentation"

@ryguyk ryguyk merged commit 7085339 into main Jan 6, 2025
18 checks passed
@ryguyk ryguyk deleted the VAGOV-TEAM-97922-sidebar-placeholder branch January 6, 2025 21:45
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.

4 participants