2026年の住所フォームテスト：40項目のQAチェックリスト

まず、すべてのフィールド、その目的、保存上限、必須かどうかを書き出します。このチェックリストの欠陥の半分は、その表がなければ評価できません。「フォームが住所を拒否した」は、どのフィールドがなぜ拒否したかが分かるまで、対処可能な情報ではないからです。

制約はグローバルではなく国ごとにすべきです。郵便番号の最大長を一律10にするとほとんどの国では機能しますが、アイルランドはスペース込み8文字で破綻し、市区町村の最大長を一律30にすると実在の名前をかなり切り詰めます。余裕のある上限を設定し、1つの市場向けに選んだ長さではなく、国のパターンで検証してください。

国を変更したら、地域をリセットし、郵便番号フィールドのラベルを変更し、キーボードとパターンを変え、古いバリデーション状態をクリアする必要があります。典型的なバグは、米国に切り替えた後もカナダの州が選択されたままで、有効に見えるフォームが不可能な値の組み合わせで送信されることです。

香港とアラブ首長国連邦には郵便番号がないため、フィールドは任意にし、ラベルでもその旨を示すべきです。日本は住所の順序が逆になるので、フォームは現地の順序でフィールドを提示するか、西洋式の順序を期待していることを明確にすべきです。切り替えは両方向でテストし、バリデーションエラーがすでに表示された後の国切り替えもテストしてください。

フォーマットはblur時に検証し、必須フィールドは送信時に検証し、値が有効になったらすぐにエラーをクリアします。キーストロークごとに検証すると、郵便番号を入力している途中のユーザーを罰することになり、送信時のみに検証すると、ユーザーは案内なしに一度に6つのエラーを発見することになります。

バリデーションの代わりに送信ボタンを無効にしないでください。説明のない無効化されたボタンは住所フォームで最もよくあるアクセシビリティの苦情です。ユーザーは何が足りないのか分からず、スクリーンリーダーが変更をアナウンスしない可能性があるからです。ボタンは有効のままにし、送信させ、各フィールドへのリンク付きのサマリーを表示してください。

エラーメッセージは、どのフィールドが間違っているか、受け入れられるフォーマットは何か、どう修正するかを伝えなければなりません。「無効な住所」は3つすべてに失敗します。「郵便番号は5桁で、例：97205」は合格です。フォーマットが特殊な国では、正規表現ではなく例を示してください。ユーザーは正規表現を読みません。

エラーはフィールドの隣に置き、フォームが長い場合は上部のサマリーにも置きます。aria-describedbyで関連付け、入力にaria-invalidを設定します。送信時には最初の無効なフィールド、またはサマリーがインタラクティブならサマリーにフォーカスを移動します。視覚的だけでなく、スクリーンリーダーでテストしてください。

貼り付けはフォーマットのバグが表面化する場所です。ユーザーが非改行スペースを含む「K1A 0B1」を貼り付けたり、完全な住所を1行目に貼り付けたりします。フォームはtrimし、既知の区切り文字を正規化し、内部のスペースを保持すべきです。ZIP+4やオランダのコードからハイフンを削除してはいけませんし、正当に大文字小文字が混在する市区町村名を大文字にしてはいけません。

自動入力は正しいトークン名に依存します。address-line1、address-line2、市区町村にはaddress-level2、地域にはaddress-level1、postal-code、countryを使用し、本当に複数行の通りのブロックでない限り、単一行フィールドでstreet-addressを再利用しないでください。モバイルでは数値キーボードに通常ハイフンがないため、inputmode="numeric"で入力されたZIP+4やオランダのコードは完了不可能になります。パターンが区切り文字を許可する場合はinputmode="text"を使用してください。

すべてのフィールドで境界値とその1文字先をテストします。切り詰めは拒否よりも悪いです。ユーザーには送信成功が見えるのに、保存された値が間違っているからです。データベースの列が50文字でフォームが100文字を許可している場合、欠陥は長い入力でのみ現れます。それは手書きのフィクスチャには決して含まれないものです。

非ASCII文字をテストします：アクセント付き文字、O Connellのアポストロフィ、フランスの通りの名のハイフン、ドイツの通りの名のエスツェット、右から左へのスクリプト。値がAPI、データベース、CSVエクスポート、印刷ラベルを通じて往復することを確認します。エンコーディングのバグはエクスポートのステップでのみ現れることが多く、それは誰もテストしないステップです。

すべてのフィールドには、入力にプログラム的に関連付けられた可視ラベルが必要です。プレースホルダーテキストはラベルではありません。入力すると消え、アナウンスも一貫しません。住所フィールドをlegend付きのfieldsetでグループ化し、国と地域のセレクトはキーボードとタイプアヘッドで操作可能にしてください。

右から左へのロケールでは、個々の入力ではなくコンテナにdirを設定し、句読点とエラーアイコンが正しい位置に留まるようにします。翻訳されたラベルが200パーセントのズームでオーバーフローしないこと、エラーサマリーが表示されたときにアナウンスされることを確認します。これらは、アクセシビリティ監査が費用を請求する欠陥を捕まえる安価なチェックです。

チェックリストを、変更のたびに実行される小さな自動化パックに変えます。20ケースで失敗の集合をカバーします：主要市場の有効ケースと無効ケースを1つずつ、カナダ、英国、ドイツ、日本、ブラジル、香港、UAEの各ケース、さらに境界長、非ASCIIの市区町村、非改行スペースを含む貼り付け値、エラー後の国切り替えです。

各ケースは独立させ、シードを設定します。結果の形状に対してアサートし、リテラル文字列に対してはアサートしません。無効ケースでは可視のエラーテキストに対してアサートします。エラー文言の回帰は実際の回帰だからです。このサイズのパックは数秒で実行され、上記の欠陥の大多数を捕まえます。