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

Offen Anfängerfreundlich
  • Stimmt etwas nicht?
#15,166 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Anfängerfreundlichkeit
86/100
Issue-Typ
Bug
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
html, javascript
Bereich
accessibility, frontend

Rechercherichtung

Das Issue verweist auf src/resources/formats/html/templates/_title-meta-author.html; lies dieses Partial und vergleiche dessen E-Mail-Link mit dem ORCID-Link in der Nähe. Rendere das bereitgestellte Autorenbeispiel und prüfe den zugänglichen Namen des Links sowie, ob das dekorative Symbol vor assistiven Technologien verborgen ist. Erledigt, wenn der E-Mail-Link einen aussagekräftigen zugänglichen Namen hat und der gemeldete axe-Verstoß link-name behoben ist.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

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
Vorherrschende Sprache
JavaScript
Sterne
6.1k
Forks
478
Ø Merge
17 Std. 58 Min.
Gemergte PRs (30 T.)
135

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus quarto-dev/quarto-cli

Alle Issues in quarto-dev/quarto-cli

Ähnliche Issues

Weitere Issues zu JavaScript

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.