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