Fix accessibility issues found by the Storybook catalog

オープン
#390 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

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

評価

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

調査の方向性

Start with ui/host/src/catalog/accessibility.ts to see the exceptions, then inspect shell.tsx, the dashboard and settings pages, dashboards/viz/health-pieces.tsx, rail.tsx, dashboards/panel-card.tsx, and settings.tsx. Run just design-check after removing an exception, or open the affected story with just design and check its Accessibility panel. Done when each listed issue is fixed and its exception is deleted.

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

説明

bug

The Storybook catalog runs axe on every story with a11y.test: "error". To keep it green, these existing issues in the shipping markup are excepted in ui/host/src/catalog/accessibility.ts. Fix each one, then delete its exception.

  • Nested and duplicate <main> landmarks. AppShell.Main in shell.tsx and the dashboard and settings pages each render a <main>. axe reports landmark-main-is-top-level (one nested main), landmark-no-duplicate-main (two mains) and landmark-unique (two unnamed mains).
  • Degraded health label contrast, light scheme. The degraded Metric label in dashboards/viz/health-pieces.tsx inherits warn text #c87d21, which is 3.275:1 on white (color-contrast, needs 4.5:1). Mantine's c prop overrides the component's darker status ink.
  • Selected chat timestamp contrast, light scheme. In rail.tsx, the dimmed timestamp on the active chat row is 3.901:1 against the selected background (color-contrast).
  • Panel loader label. The labelled Mantine Loader in dashboards/panel-card.tsx (aria-label="Loading panel") renders a span with no role (aria-prohibited-attr). Give it role="status" or use visually hidden text.
  • Settings documentation link. The "Sending telemetry" link in settings.tsx inherits the text colour and underlines only on hover. That is 1.289:1 against the surrounding text (link-in-text-block). Underline it at rest, or give it link colour.

Reproduce: run just design-check after removing an exception, or open the story in just design and check the Accessibility panel.

主要言語
Go
スター
11
フォーク
0
平均マージ
7時間 39分
マージ済み PR(30日)
97

環境構築

はじめの一歩

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

labstack/fanout のほかの issue

labstack/fanout の issue をすべて見る

似ている issue

Go の issue をもっと見る

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

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