Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[SideNavigationItem]: accessibleName is ignored by screen readers when text is set

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

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

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

評価

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

調査の方向性

SideNavigationItem の実装とアクセシビリティテストから始めます。issue では、shadow DOM の treeitem と、競合する aria-label および aria-labelledby 属性が示されています。accessibleName と text がこれらの属性をどのように設定するかを追い、手順で説明されている NVDA の読み上げの違いを再現します。両方の props が設定されているときに accessibleName が読み上げられ、このケースを対象とする回帰テストがあることが完了条件です。

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

説明

ACC bug TOPIC RD
Bug Description

Setting accessibleName on a SideNavigationItem has no effect on the accessible name when text is also provided.

The root cause: when text is set, the shadow DOM div[role="treeitem"] gets both aria-label (from accessibleName) and aria-labelledby (pointing to the internal text span). Per the ARIA spec, aria-labelledby always wins, so aria-label is ignored.

When text is omitted, aria-labelledby is not set and accessibleName works as expected.

Affected Component

SideNavigationItem

Expected Behaviour

When accessibleName is set, aria-labelledby should either be removed or the element it references should contain the accessibleName value. The prop was added specifically to override the default accessible name - it should win.

Isolated Example

No response

Steps to Reproduce
  1. Render
  2. Inspect the shadow root - div[role="treeitem"] has:
    aria-label="Inbox, 3 unread notifications"
    aria-labelledby="ui5wc_xx-text" pointing to Inbox
  3. Navigate to the item with NVDA - it announces "Inbox", not "Inbox, 3 unread notifications"
  4. Remove text prop - NVDA now announces "Inbox, 3 unread notifications" correctly
Log Output, Stack Trace or Screenshots

No response

Priority

None

UI5 Web Components Version

2.25.0

Browser

Chrome

Operating System

Windows, Screen reader: NVDA

Additional Context

No response

Organization

No response

Declaration
  • I’m not disclosing any internal or sensitive information.
主要言語
TypeScript
スター
1.8k
フォーク
289
平均マージ
3日 17時間
マージ済み PR(30日)
55

環境構築

はじめの一歩

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

UI5/webcomponents のほかの issue

UI5/webcomponents の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

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

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