HTML Tag Reference

aria-invalid 属性

入力値が不正であることを示す

aria-invalid 属性は、入力された値がフォームなど、アプリケーションが期待する形式に適合していないことを示します。

例えば、数値のみの入力が許された入力欄にテキストが入力された、あるいはある範囲の値のみ入力可能な入力欄にその範囲から外れる値が入力された場合など、該当する入力コントロールに aria-invalid="true" を付与して、入力された値が不正であることを示すことができます。

なお、aria-required 属性の値が true である入力コントロールに未入力の状態でデータが送信されようとしようとしたときにも、その入力コントロールに aria-invalid="true" を付与して、エラーであることを通知することもできます。ただし、フォームが送信されようとする前、ユーザーが、まだデータを何も入力していないという理由だけで、入力が必須の入力コントロールに aria-invalid="true" を設定すべきではありません。

aria-invalid 属性の仕様

この属性を使用できる要素
  • すべての HTML 要素

aria-invalid 属性のサンプルソース

<p>
  <label for="fullname">お名前（必須）</label> 
  <input type="text" name="fullname" id="fullname" required  aria-required="true" aria-invalid="true" aria-describedBy="error-fullname" />
  <span id="error-fullname">お名前が入力されていません</span>
</p>

用途から目的の要素を探す

用途から HTML 要素を逆引きできます。