モーダルのセマンティクス、キーボード動作、フォーカス処理、アナウンス、および包括的なインタラクションルールを指定します。このリファレンスは採用の境界、失敗時の動作、および観察可能な証拠を固定しつつ、環境固有の制限は設定可能なままにします。
パッケージの状態: リファレンスコンテキストは人間によるレビュー準備完了。契約とテストシナリオは完成していますが、採用実装がこれらを通過したという主張はしていません。
決定
モーダルについては、利用可能なネイティブセマンティクスを用いた再利用可能な状態およびインタラクション契約を採用します。コンポーネントの機能契約の一部として、セマンティクス、キーボード、フォーカス、アナウンス、視覚、モーション、およびエラー動作を指定します。このアクセシビリティブロックは特にアクセシビリティ契約に焦点を当てています。このパッケージはリファレンス契約であり、採用チームは自身の環境の証拠から数値制限、プロバイダー、管轄区域、および運用責任者を選択する必要があります。
範囲
- モーダルのアクター、入力、出力、状態、ポリシーまたはスキーマバージョン、およびこのアクセシビリティブロックのアクセシビリティ契約に必要な外部に見える結果。
- 主要および代替インターフェース、バックグラウンド作業、キャッシュ、統合、サポートパス、および同じ境界を行使できる証拠。
- リファレンスを安全に適用するために必要な採用固有の設定、展開、回復、および検証の責任。
このブロックの外
- すべての採用者に対するユニバーサルベンダー、フレームワーク、管轄区域、数値閾値、保持期間、またはサービスレベル目標の選択。
- パッケージされたシナリオが下流の実装で実行されたことの主張や、このリファレンスが法的、セキュリティ、アクセシビリティ認証を付与することの主張。
契約
- パターンが入ることができるトリガー、開くまたはアクティブ、読み込み中、成功、空、無効、エラー、無効化、および閉鎖状態を定義する。
- キーボード入力、フォーカスの入りと戻り、アクセシブルネーム、アナウンス、ポインター動作、およびタッチターゲット動作をまとめて指定する。
- 破壊的、不可逆的、または外部効果を明示し、作業が保留中は重複起動を防止する。
- 狭い幅、高ズーム、テキスト拡大、強制色、減速モーションでもコンテンツ階層とアクションを使いやすく保つ。
- ネイティブ要素を優先し、カスタムウィジェットが必要な場合はロールを追加するだけでなく、期待される完全なインタラクションパターンを実装する。
- 複数の入力モードと、採用チームが定義した少なくとも1つの代表的なスクリーンリーダー/ブラウザ組み合わせでテストする。
- モーダルコンテンツを名前付きダイアログとして公開し、意味のある初期ターゲットにフォーカスを移動し、インタラクションを囲い込み、背景を非活性化し、閉じたときに有効な開始コンテキストにフォーカスを復元する。
- Escape、閉じるボタン、破壊的確認、ネストされたオーバーレイ、ルートおよびブラウザバック、スクロールロック、検証、小画面動作をキーボードやスクリーンリーダーユーザーを閉じ込めることなく定義する。
- アクセシビリティ契約バリアントでは、この宣言された境界を強制する：モーダルのセマンティクス、キーボード動作、フォーカス処理、アナウンス、および包括的なインタラクションルールを指定。
実装ガイダンス
- 実装前にキーボードとフォーカスのシーケンスを書き、目に見えるラベルとプログラム的な名前を並べてレビューする。
- フレームワークやベンダーの詳細を選択する前に、モーダルの入力、出力、アクター、状態、不変条件、副作用、および証拠をモデル化する。
- 適用されるモーダル契約またはポリシーバージョンをマテリアル状態と共に保存し、マイグレーション、リプレイ、およびサポートの決定が帰属可能なようにする。
- 制御された展開の背後にパスを導入し、期待される結果と観察された結果を比較し、採用証拠が完了するまでテスト済みの回復ルートを維持する。
失敗処理と安全策
- アクション失敗時は関連する入力とフォーカスを保持し、結果をアナウンスし、コンポーネントを安全な回復パスのある状態に戻す。
- 無効または矛盾するモーダル状態は拒否または隔離される。実装は権限を拡大したり効果を重複させる値を推測しない。
- リトライは制限され耐久的な識別子を使用し、使い果たした後は検査可能な終端状態に達し、責任者がいる。
検証と運用
- 自動ルール、キーボードのみの操作、フォーカスの可視性、アナウンス、コントラスト、ズーム、および手動タスク完了を検証する。
- モーダルの成功、拒否、検証失敗、依存失敗、リトライ使い果たし、および契約バージョンごとの回復を機密ペイロードの寸法なしで監視する。
- ポリシー、スキーマ、依存関係、マイグレーション、または境界の変更後に正負のフィクスチャを再実行し、結果の証拠を保持する。
採用の前提
- 例の名前と値は具体的なフィクスチャであり、普遍的なデフォルトではない。採用者は文書化された証拠と所有権を通じてこれらを置き換える。
- 採用システムは認証された識別、耐久的な操作または記録バージョン、制限されたテレメトリ、および制御された変更パスを提供できる。
このパッケージの実行可能に見える例はフィクスチャおよび受け入れ契約です。構造とメタデータをチェックするためにコレクションバリデータを実行し、ターゲットリポジトリでシナリオを翻訳・実行してから実装証拠を記録してください。