A mechanism that detects when an input value does not match the interval defined by the step
attribute.
stepMismatch
は、HTML フォーム要素の検証(バリデーション)において、入力値が <input>
要素の step
属性で指定された間隔に適合していない場合に true
となるプロパティです。例えば、<input type="number" step="5">
では、0, 5, 10 のような5刻みの値のみが許可され、7 のように指定されたステップに合わない値を入力すると stepMismatch
が true
を返します。
stepMismatch
は、HTMLInputElement.validity
オブジェクトの一部であり、ブラウザによる組み込みバリデーション機能で自動的に判定されます。JavaScriptで inputElement.validity.stepMismatch
を確認すれば、ユーザーが入力した値が step
属性のルールに違反しているかを簡単に判定できます。
フォームのユーザー体験を向上させるために、stepMismatch
を使ってカスタムエラーメッセージを出したり、送信前に無効な値を防ぐことが可能です。