JavaScript

A mechanism that detects when an input value does not match the interval defined by the step attribute.

stepMismatch

stepMismatch は、HTML フォーム要素の検証(バリデーション)において、入力値が <input> 要素の step 属性で指定された間隔に適合していない場合に true となるプロパティです。例えば、<input type="number" step="5"> では、0, 5, 10 のような5刻みの値のみが許可され、7 のように指定されたステップに合わない値を入力すると stepMismatchtrue を返します。

stepMismatch は、HTMLInputElement.validity オブジェクトの一部であり、ブラウザによる組み込みバリデーション機能で自動的に判定されます。JavaScriptで inputElement.validity.stepMismatch を確認すれば、ユーザーが入力した値が step 属性のルールに違反しているかを簡単に判定できます。

フォームのユーザー体験を向上させるために、stepMismatch を使ってカスタムエラーメッセージを出したり、送信前に無効な値を防ぐことが可能です。