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

オープン 初心者向け
#15,166 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
86/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
html, javascript

調査の方向性

Issue は src/resources/formats/html/templates/_title-meta-author.html を指しています。その partial を読み、メールリンクと近くにある ORCID リンクを比較してください。提示された著者の例をレンダリングし、リンクのアクセシブルネームと、装飾アイコンが支援技術から隠されているかを確認してください。メールリンクに意味のあるアクセシブルネームがあり、報告された axe の link-name 違反が解消されれば完了です。

索引モデルが issue の本文から書いたものです。

説明

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
主要言語
JavaScript
スター
6.1k
フォーク
478
平均マージ
17時間 7分
マージ済み PR(30日)
112

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

quarto-dev/quarto-cli のほかの issue

quarto-dev/quarto-cli の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。