HTMLガイドライン

🔰 当ドキュメントは「コーディングガイドライン」の一部です。基本的なガイドライン・ルールについては先にそれから確認してください。

ガイドラインの目的

HTMLのガイドラインは次の3つを主な目的として規定します。

セマンティック・アクセシビリティ
- コンテキスト（文章などの前後の脈絡・文脈）によって最適なマークアップができること
- 普遍的でアクセシブルなマークアップができること
一貫性
- 一貫したルールがあることで個人の好みや矜持による品質のバラツキを抑えること
- プロジェクトをまたいでも混乱が少ないこと
メンテナンス性
- デザインの変更に対して柔軟で応用が効く汎用的な作りであること
- コンポーネントの単位で影響範囲を把握しやすく管理できること

次の規格やガイドラインを参考に最適な実装をしていきます。

原則としてHTML Living Standardの規定は例外なく従います。

WAI-ARIAはWAI-ARIA 1.2を基本に、ブラウザや支援技術の実装状況を鑑みながら判断します。

WCAG 2.2の4原則（知覚可能、操作可能、理解可能、堅牢性）に基づいてマシンリーダブルなマークアップをします。

ARIA Authoring Practices Guide (APG)を参考にUIを実装します。特にARIA属性やキーボードの操作については特別な理由がない限りこれに則って実装します。