Skip to content

UI: Update Swagger Title Element#30816

Closed
lane-wetmore wants to merge 2 commits into
mainfrom
ui/VAULT-32403-Swagger-A11y-Fix
Closed

UI: Update Swagger Title Element#30816
lane-wetmore wants to merge 2 commits into
mainfrom
ui/VAULT-32403-Swagger-A11y-Fix

Conversation

@lane-wetmore
Copy link
Copy Markdown
Contributor

@lane-wetmore lane-wetmore commented Jun 2, 2025

Description

This PR addresses an a11y violation found in the swagger title.

  • A page header title element has been added to follow a11y hierarchy order and stay consistent with other titles across the UI.

Previous

image

Current

image image

TODO only if you're a HashiCorp employee

  • Backport Labels: If this fix needs to be backported, use the appropriate backport/ label that matches the desired release branch. Note that in the CE repo, the latest release branch will look like backport/x.x.x, but older release branches will be backport/ent/x.x.x+ent.
    • LTS: If this fixes a critical security vulnerability or severity 1 bug, it will also need to be backported to the current LTS versions of Vault. To ensure this, use all available enterprise labels.
  • ENT Breakage: If this PR either 1) removes a public function OR 2) changes the signature
    of a public function, even if that change is in a CE file, double check that
    applying the patch for this PR to the ENT repo and running tests doesn't
    break any tests. Sometimes ENT only tests rely on public functions in CE
    files.
  • Jira: If this change has an associated Jira, it's referenced either
    in the PR description, commit message, or branch name.
  • RFC: If this change has an associated RFC, please link it in the description.
  • ENT PR: If this change has an associated ENT PR, please link it in the
    description. Also, make sure the changelog is in this PR, not in your ENT PR.

@lane-wetmore lane-wetmore requested a review from a team as a code owner June 2, 2025 21:32
@github-actions github-actions Bot added the hashicorp-contributed-pr If the PR is HashiCorp (i.e. not-community) contributed label Jun 2, 2025

// Update the title to be an h1 tag to align with a11y standards
setTimeout(() => {
const oldTitle = element.querySelector('.swagger-ui .title');
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

It isn't ideal to replace the tag this way, but it isn't possible to update the title of the Swagger Info component with a plugin unless we replace the entire thing. I've added a test for this in case these selectors change.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This looks fine but I wonder if it would be better to schedule this to run in the afterRender queue rather than waiting for that fixed amount of time? That should fire after all the view rendering has completed which should ensure that the h2 tag you are looking to replace is in the DOM.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jun 2, 2025

Build Results:
All builds succeeded! ✅

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jun 2, 2025

CI Results:
All Go tests succeeded! ✅

@lane-wetmore lane-wetmore deleted the ui/VAULT-32403-Swagger-A11y-Fix branch June 6, 2025 17:01
@lane-wetmore lane-wetmore restored the ui/VAULT-32403-Swagger-A11y-Fix branch June 6, 2025 17:01
@lane-wetmore
Copy link
Copy Markdown
Contributor Author

Wrong ticket linked - opened a new PR with correct branch info #30888

@lane-wetmore lane-wetmore deleted the ui/VAULT-32403-Swagger-A11y-Fix branch June 6, 2025 17:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

hashicorp-contributed-pr If the PR is HashiCorp (i.e. not-community) contributed pr/no-changelog ui

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants