본문으로 건너뛰기
cccskills
무료GitHub에 공개

dzero-a11y

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

d-zero-dev/frontend-guidelines
설치 방법 보기

포함된 파일(1)

  • SKILL.md2.8 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

アクセシビリティ規約

マークアップの規範は 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 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

dzero-css

무료

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

d-zero-dev/frontend-guidelines202026년 10월 15일 업데이트

dzero-design-to-code

무료

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

d-zero-dev/frontend-guidelines202026년 10월 15일 업데이트

dzero-html

무료

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일 업데이트

dzero-review

무료

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

d-zero-dev/frontend-guidelines202026년 10월 15일 업데이트

dzero-tech-selection

무료

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

d-zero-dev/frontend-guidelines202026년 10월 15일 업데이트

d-zero-dev의 스킬 모두 보기

이 스킬의 문제 신고