Skip to content

Make the tool choosers consistent - #2258

Merged
cwickham merged 2 commits into
mainfrom
fix/tool-chooser-consistency
Oct 2, 2026
Merged

cwickham merged 2 commits into
mainfrom
fix/tool-chooser-consistency

Conversation

@cwickham

@cwickham cwickham commented Oct 1, 2026 •

Copy link
Copy Markdown
Member

The five "Choose your tool" interfaces had different labels and markup, and copied CSS and JS. This PR makes them consistent.

  • Get started, manuscripts and extensions: a new page-chooser shortcode (_extensions/page-chooser/) replaces three copies of the markup, CSS and script. Each chooser is now a <nav> named by a visible label, with aria-current on the active page. The items are in _metadata.yml.
  • tools-tabset: aria-labelledby on the visible label replaces aria-hidden plus aria-label. A selected tab no longer changes size.
  • Landing cards: role="button" is removed from the links. The manuscripts logos are decorative (alt=""). The cards now show a visible focus ring (WCAG 2.4.7).
  • CSS: the inline <style> in the extensions chooser is removed. The .tool rules are the same in both tutorial.css files, and these rules no longer apply to other links on the page.
  • "Editor" is now "Text Editor" in the get-started chooser, the same as on the landing page.

An axe scan of the same 32 pages before and after the change shows no new findings. Screenshots below.

Where to check

Related: #2222. This PR adds new files and changes filters/tools-tabset.lua, which #2222 renames. There is one small conflict in styles.css.

@github-actions

github-actions Bot commented Oct 1, 2026

Copy link
Copy Markdown
Contributor

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-2258.quarto.org

🔄 Modified Documents

@github-actions

github-actions Bot commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-2258.quarto.org

🔄 Modified Documents

@cwickham
cwickham marked this pull request as ready for review October 2, 2026 15:26
@cwickham
cwickham merged commit dab304a into main Oct 2, 2026
3 checks passed
@cwickham
cwickham deleted the fix/tool-chooser-consistency branch October 2, 2026 15:26
@github-actions

github-actions Bot commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

Backport failed for prerelease, because it was unable to cherry-pick the commit(s).

Please cherry-pick the changes locally and resolve any conflicts.

git fetch origin prerelease
git worktree add -d .worktree/sync-2258-to-prerelease origin/prerelease
cd .worktree/sync-2258-to-prerelease
git switch --create sync-2258-to-prerelease
git cherry-pick -x dab304ac66444f870c8950bfa3a9c42d8a641120

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.

1 participant