Skip to content

Give the visual editor screenshots real alt text - #2195

Merged
cwickham merged 2 commits into
mainfrom
fix/visual-editor-fig-alt
Sep 23, 2026
Merged

cwickham merged 2 commits into
mainfrom
fix/visual-editor-fig-alt

Conversation

@cwickham

Copy link
Copy Markdown
Member

Seven screenshots on the visual editor pages had no accessible name. They used raw <img> tags with fig-alt=. Only Quarto's Markdown image syntax understands fig-alt. Pandoc passes raw HTML through unchanged, so the browser ignored the attribute.

This PR changes the seven tags to Markdown images. The alt text is the same. The caption is empty, so each image stays a plain image and does not become a figure. The .illustration class and the widths are unchanged.

Pages:

  • docs/visual-editor/options.qmd (3 images)
  • docs/visual-editor/technical.qmd (3 images)
  • docs/tools/_code-oss-visual-editor.md (1 image, included on the VS Code and Positron visual editor pages)

A second commit corrects the alt text for the Zotero group library screenshot. The old text had a missing word and a missing closing quote.

Evidence

quarto call axe on the 7 affected pages, before and after, with the same --pages:

  • 2 image-alt findings cleared (both on options.html)
  • image-alt :: img[width="*"] went from 13 to 7 instances. The 7 that remain are images with no alt text at all, which a later PR will fix.
  • No new findings, and all cells completed in both runs.

Seven raw <img> tags used fig-alt=, which only Quarto's Markdown image
syntax understands. The browser ignored it, so the images had no
accessible name. Convert them to Markdown images with an empty caption
so they stay plain images, not figures.
@github-actions

Copy link
Copy Markdown
Contributor

📝 Preview Deployment

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

🔄 Modified Documents

@cwickham
cwickham marked this pull request as ready for review September 23, 2026 16:16
@cwickham
cwickham merged commit 0d68f22 into main Sep 23, 2026
3 checks passed
@cwickham
cwickham deleted the fix/visual-editor-fig-alt branch September 23, 2026 16:16
@github-actions

Copy link
Copy Markdown
Contributor

Successfully created backport PR for prerelease:

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