アクセシブルなテーブル：アクセシビリティ要件
アクセシブルなテーブルに関する包括的な動作、セマンティック要件、支援技術の期待、および一般的な失敗ケースを定義します。採用の境界と観察可能な失敗証拠を固定しつつ、環境固有の制限は設定可能なままにします。
パッケージの状態： 参照コンテキストは人間によるレビュー準備完了。契約とテストシナリオは完成していますが、採用実装がこれらを通過したという主張はありません。
決定
アクセシブルなテーブルについては、まずネイティブのセマンティクスを採用し、文書化されたキーボードおよびフォーカスの契約を設けます。コンポーネントの機能契約の一部として、セマンティック、キーボード、フォーカス、アナウンス、視覚、動作、およびエラーの動作を指定します。このパッケージは参照契約であり、採用チームは自環境の証拠に基づいて数値制限、プロバイダー、管轄区域、および運用責任者を選択する必要があります。
範囲
- このアクセシビリティブロックで説明されるアクセシブルなテーブルのアクター、入力、出力、状態、ポリシーまたはスキーマのバージョン、および外部に見える結果。
- 主および代替インターフェース、バックグラウンド作業、キャッシュ、統合、サポートパス、および同じ境界を動作させる証拠。
- 参照を安全に適用するために必要な採用固有の設定、展開、回復、および検証の責任。
このブロックの外
- すべての採用者に対して普遍的なベンダー、フレームワーク、管轄区域、数値閾値、保持期間、またはサービスレベル目標を選択すること。
- パッケージ化されたシナリオが下流の実装で実行されたことや、この参照が法的、セキュリティ、アクセシビリティ認証を付与することを主張すること。
契約
- 視覚インターフェースが伝えるプログラム可能な名前、役割、値、状態、および関係をすべて公開すること。
- すべての操作はキーボードでトラップなく操作可能であり、フォーカス順序は読み取りおよび操作順に従うこと。
- フォーカスを予期せず移動させることなく非同期の状態やエラーをアナウンスし、回復ガイダンスを影響を受けたコントロールに関連付けること。
- ズーム、文字間隔、リフロー、強制カラー、動作軽減、およびプラットフォームのテキストスケーリングにおいて、コンテンツと操作を保持すること（該当する場合）。
- ネイティブ要素を優先し、カスタムウィジェットが必要な場合は、役割を追加するだけでなく完全な期待されるインタラクションパターンを実装すること。
- 複数の入力モードと、採用チームが定義した代表的なスクリーンリーダー／ブラウザの組み合わせでテストすること。
- キャプションまたはアクセシブル名と、ソート、フィルター、ページネーション、レスポンシブ変換後も正しいままのプログラム可能な行および列ヘッダーの関係を提供すること。
- 選択、ソート状態、位置、合計、および行アクションをキーボードおよび支援技術に公開し、仮想化されたコンテンツを一貫した読み取りおよびフォーカス順序に保つこと。
実装ガイダンス
- 実装前にキーボードおよびフォーカスのシーケンスを書き、可視ラベルとプログラム可能な名前を並べてレビューすること。
- フレームワークやベンダーの詳細を選択する前に、アクセシブルなテーブルの入力、出力、アクター、状態、不変条件、副作用、および証拠をモデル化すること。
- 適用されるアクセシブルなテーブルの契約またはポリシーバージョンをマテリアル状態と共に保存し、マイグレーション、再生、およびサポートの決定が帰属可能であるようにすること。
- 制御された展開の背後にパスを導入し、期待される結果と観察された結果を比較し、採用証拠が完了するまでテスト済みの回復ルートを維持すること。
失敗処理と安全策
- セマンティクスやフォーカスを保持できない場合、そのインタラクションは視覚のみの動作の背後で出荷されず、欠陥はリリースブロッキングのままとすること。
- 無効または矛盾するアクセシブルなテーブルの状態は拒否または隔離され、実装は権限を拡大したり効果を重複させる値を推測しないこと。
- リトライは制限され、耐久的な識別子を使用すること。使い果たした後は、作業は検査可能な終端状態に達し、責任者が明確であること。
検証と運用
- 自動ルール、キーボードのみの操作、フォーカスの可視性、アナウンス、コントラスト、ズーム、および手動タスクの完了を検証すること。
- アクセシブルなテーブルの成功、拒否、検証失敗、依存失敗、リトライ使い果たし、および回復を契約バージョンごとに監視し、機密性の高いペイロードの詳細は含めないこと。
- ポリシー、スキーマ、依存関係、マイグレーション、または境界の変更後に正負のフィクスチャをペアで再実行し、得られた証拠を保持すること。
採用の前提
- 例にある名前と値は具体的なフィクスチャであり、普遍的なデフォルトではない。採用者は文書化された証拠と所有権を通じてこれらを置き換えること。
- 採用システムは認証済みの識別、耐久的な操作または記録バージョン、制限されたテレメトリ、および変更のための制御されたパスを提供できること。
このパッケージの実行可能に見える例はフィクスチャおよび受け入れ契約です。
構造とメタデータをチェックするためにコレクションバリデータを実行し、ターゲットリポジトリでシナリオを翻訳および実行してから実装証拠を記録してください。