跳到正文
cccskills
免费在 GitHub 公开

dzero-a11y

D-ZERO のアクセシビリティ規約。マークアップやインタラクションの実装・変更・レビューで、WAI-ARIA、代替テキスト(alt)、ランドマーク、見出し、キーボード操作、フォーカスを扱うときに使う。

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(1)

  • SKILL.md2.8 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

アクセシビリティ規約

マークアップの規範は dzero-html と併せて適用する。詳細は HTML: アクセシビリティ を参照。

実装規範

準拠基準

  • 準拠基準は WCAG 2.2。WAI-ARIA は 1.2 を基本に、ブラウザ・支援技術の実装状況を鑑みて判断する

WAI-ARIA の使いどころ

  • WAI-ARIA を使うのは HTML 標準では再現できないコンポーネントを作成するときのみ。HTML 標準に要素がある場合や Popover などで済む場合は使わない
  • 使う必要があるケース: button が aria-pressed / aria-expanded などの状態を持つ場合、タブやカルーセルなど HTML にないコンポーネントを扱う場合
  • 使う場合は APG を参考に、インタラクション要件・キーボード操作・振る舞いを推奨実装に近づける(特別な理由がない限り APG に則る)。実装例は APG Patterns Examples も参考にする
  • 状態を表す属性の使い分けは dzero-html の状態管理に従う

代替テキスト

  • alt は WCAG 達成基準 1.1.1「同等の目的」を基準に考える。コーディング段階ではなくデザイン段階で代替テキストが決まるように計画する(決まっていなければユーザーに確認する)
  • 装飾ではない通常の img に aria-hidden="true" を付けない。装飾画像は alt=""(空 alt)が正解
  • alt が空の場合に role="none"(role="presentation")を重ねて付けない(空 alt で同じ効果が得られる)

ランドマーク

  • 各コンポーネントの先祖となる要素にランドマークを設ける。もしくはコンポーネントルート自体をランドマークを持つ要素でマークアップする

キーボード操作とフォーカス

  • キーボード操作の要件は APG の該当パターンに則る(実装例の参考: APG Patterns Examples)
  • インタラクティブ要素には :focus-visible によるフォーカス表示を実装する。デザインカンプに描かれていなくても省略しない(dzero-design-to-code 参照)。フォーカス表示を消すだけのスタイル(outline: none 等)を書かない

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

dzero-css

免费

D-ZERO の CSS コーディング規約。CSS を書く・編集する・レビューするときに使う。コンポーネントのスタイル、レイアウト、レスポンシブ、カスタムプロパティ、セレクタ設計に適用する。

中文简介正在准备中。当前显示原文说明。

d-zero-dev/frontend-guidelines202026年10月15日 更新

デザインデータ(Figma などのデザインカンプ)を参照してコーディングするときの解釈原則とアセットの扱い。Figma の URL・MCP・デザイン画像・カンプをもとに実装や修正をするときに必ず使う。

中文简介正在准备中。当前显示原文说明。

d-zero-dev/frontend-guidelines202026年10月15日 更新

D-ZERO の HTML/Pug マークアップ規約。HTML や Pug を書く・編集する・レビューするときに使う。コンポーネント設計、クラス命名、文書構造、画像、リンク、メタ情報に適用する。

中文简介正在准备中。当前显示原文说明。

d-zero-dev/frontend-guidelines202026年10月15日 更新

dzero-js

免费

D-ZERO の JavaScript/TypeScript コーディング規約。JS/TS を書く・編集する・レビューするときに使う。イベント処理、DOM 操作、状態変更、ライブラリ追加、スクリプト読み込みに適用する。

中文简介正在准备中。当前显示原文说明。

d-zero-dev/frontend-guidelines202026年10月15日 更新

フロントエンド実装のコードレビューを実施する。PR レビュー、コードレビュー、実装チェック、品質確認を依頼されたときに使う。実装レイヤー選定の妥当性から各技術軸の観点まで順に検査する。

中文简介正在准备中。当前显示原文说明。

d-zero-dev/frontend-guidelines202026年10月15日 更新

UI・機能・コンポーネントの実装レイヤー(HTML/CSS/JavaScript)を決定する判断基準。実装・修正の着手前に必ず読む。アコーディオン、モーダル、ポップオーバー、開閉・切替などのインタラクション実装を依頼されたときに使う。

中文简介正在准备中。当前显示原文说明。

d-zero-dev/frontend-guidelines202026年10月15日 更新

查看 d-zero-dev 的全部技能

报告此技能的问题