このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

ARIA: aria-errormessage 属性

オブジェクトの aria-errormessage 属性は、そのオブジェクトのエラーメッセージを提供する要素(1 つまたは複数)を特定します。

解説

ユーザーの操作によってエラーが生じた場合は、そのことをユーザーに知らせ、修正方法を伝える必要があります。使用する属性は 2 つです。まず aria-invalid="true" を設定してオブジェクトがエラー状態であることを示し、次に aria-errormessage 属性を追加します。その値には、オブジェクトのエラーメッセージのテキストを含む要素の id、または複数の要素の id を空白区切りで並べたリストを指定します。

aria-errormessage 属性を使用するのは、オブジェクトの値が無効である場合、つまり aria-invalid が true に設定されている場合に限ります。オブジェクトが有効であるにもかかわらず aria-errormessage 属性を含める場合は、参照先の要素を非表示にしてください。そこに含まれるメッセージは無関係だからです。

aria-errormessage が関連する場合は、ユーザーがエラーメッセージを見たり聞いたりできるよう、参照先の要素を表示する必要があります。

エラーメッセージを含む要素は、多くの場合 ARIA ライブ領域にするとよいでしょう。例えば、ユーザーが無効な値を入力した後にエラーメッセージを表示する場合です。エラーメッセージでは、何が誤っているかを説明し、オブジェクトを有効にするために必要な操作をユーザーに伝えてください。エラーメッセージを ARIA ライブ領域にすると、通常の方法ではユーザーに伝えられない場合でも、ユーザーがその内容から情報を得られる可能性があることを支援技術に知らせます。

失敗が視覚的に明らかで、エラーの明示的な説明が必要な場合は、エラーメッセージを表示し、aria-errormessage 属性で無効なオブジェクトに関連付けてください。

値

ID 参照リスト

現在の要素のエラーメッセージを含む要素の id、またはそのような id を空白区切りで並べたリストです。

関連インターフェイス

Element.ariaErrorMessageElements

ariaErrorMessageElements プロパティは各要素のインターフェイスの一部です。その値は、aria-errormessage 属性の id 参照を反映する Element のサブクラスのインスタンスの配列です (いくつかの注意点があります)。

ElementInternals.ariaErrorMessageElements

ariaErrorMessageElements プロパティは各カスタム要素のインターフェイスの一部です。その値は、aria-errormessage 属性の id 参照を反映する Element のサブクラスのインスタンスの配列です (いくつかの注意点があります)。

関連付けられたロール

次のロールで使用されます。

次のロールにも継承されます。

例

次のスタイルを作成します。

  1. すべてのエラーメッセージを非表示にする。
  2. 無効なオブジェクトがそうと分かる外観にする。
  3. 無効なオブジェクトの後に兄弟要素として置かれたエラーメッセージを表示する。

aria-invalid="true" を使用して、無効なオブジェクトを特定します。

css
.errormessage {
  visibility: hidden;
}

[aria-invalid="true"] {
  outline: 2px solid red;
}

[aria-invalid="true"] ~ .errormessage {
  visibility: visible;
}

オブジェクトが無効な場合は、JavaScript を使用して aria-invalid="true" を追加します。上記の CSS は、無効なオブジェクトの後にある .errormessage を表示します。

html
<p>
  <label for="email">メールアドレス:</label>
  <input
    type="email"
    name="email"
    id="email"
    aria-invalid="true"
    aria-errormessage="err1" />
  <span id="err1" class="errormessage"
    >エラー: 有効なメールアドレスを入力してください</span
  >
</p>

対象が有効から無効に変わった際、この例ではメール入力要素の aria-invalid を更新するだけで済みました。エラーメッセージは入力欄の後に配置され、表示されるとアクセシビリティツリーからも利用できるため、例をシンプルに保てます。aria-live プロパティを適用したり、alert のようなライブ領域のロールを使用したりする方法もあります。

仕様書

仕様書
Accessible Rich Internet Applications (WAI-ARIA)
# aria-errormessage

関連情報