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

Abierto Apto para principiantes
  • ¿Algo no está bien?
#15,166 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
86/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
html, javascript
Área
accessibility, frontend

Línea de trabajo

El issue apunta a src/resources/formats/html/templates/_title-meta-author.html; lee ese partial y compara su enlace de correo electrónico con el enlace ORCID cercano. Renderiza el ejemplo de autor proporcionado e inspecciona el nombre accesible del enlace y si el icono decorativo está oculto para las tecnologías de asistencia. Se considera terminado cuando el enlace de correo electrónico tiene un nombre accesible significativo y se resuelve la infracción link-name de axe reportada.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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
Lenguaje dominante
JavaScript
Estrellas
6.1k
Forks
478
Merge medio
17 h 7 min
PR fusionados (30 d)
112

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de quarto-dev/quarto-cli

Todos los issues de quarto-dev/quarto-cli

Issues similares

Más issues de JavaScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.