Author email link in the HTML title block has no accessible name

Aperta Adatta ai principianti
  • Qualcosa non va?
#15,166 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
86/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
html, javascript
Ambito
accessibility, frontend

Direzione di ricerca

La issue rimanda a src/resources/formats/html/templates/_title-meta-author.html; leggi quel partial e confronta il suo link e-mail con il link ORCID nelle vicinanze. Esegui il rendering dell’esempio di autore fornito e controlla il nome accessibile del link e se l’icona decorativa è nascosta alle tecnologie assistive. Il lavoro è completato quando il link e-mail ha un nome accessibile significativo e la violazione link-name segnalata da axe è risolta.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

accessibility bug
I have:
  • searched the issue tracker for similar issues
  • installed the latest version of Quarto CLI
  • formatted my issue following the Bug Reports guide
Bug description

When an author has an email, the HTML title block renders a mailto: link that contains only an icon font glyph.
The link has no text, no aria-label and no title, so assistive technology announces it as an empty link.
axe-core reports link-name (serious, WCAG 2.2 SC 2.4.4 and 4.1.2) on it.

The _title-meta-author.html partial writes the email link with an <i class="bi bi-envelope"> and nothing else.
The ORCID link in the same partial does carry an aria-label, so the email link is the only one of the two without a name.

Steps to reproduce
---
title: "Author email test"
author:
  - name: Jane Doe
    email: [email protected]
format: html
---

Content.

quarto render index.qmd
grep -o '<a[^>]*mailto[^>]*>.\{0,80\}' index.html
Actual behavior
<a href="mailto:[email protected]" class="quarto-title-author-email"><i class="bi bi-envelope"></i></a>

Running the axe.min.js that ships with Quarto against the rendered page gives one violation: link-name, impact serious, on this link.

Expected behavior

The email link has an accessible name that says what it does, for example "Email Jane Doe", and the decorative icon is hidden from assistive technology, as the ORCID link already is.

Your environment
  • IDE: none, terminal only
  • OS: macOS (Darwin 27.0.0, Apple Silicon)
Quarto check output
Quarto 99.9.9
[✓] Checking versions of quarto binary dependencies...
      Pandoc version 3.10.0: OK
      Dart Sass version 1.101.0: OK
      Deno version 2.7.14: OK
      Typst version 0.15.1: OK
[✓] Checking Quarto installation......OK
      Version: 99.9.9
      commit: 69592e5c1718d3e1b2f3d11e757d32e23a16af67
Lingua principale
JavaScript
Stelle
6.1k
Fork
478
Merge medio
17h 7m
PR unite (30g)
112

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di quarto-dev/quarto-cli

Tutte le issue di quarto-dev/quarto-cli

Issue simili

Altre issue su JavaScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.