pattern 属性は、フォームコントロールの値が一致すべき正規表現を指定します。null 以外の値がpattern 値によって設定された制約に適合しない場合、ValidityState オブジェクトの読み取り専用のpatternMismatch プロパティが真になります。

試してみましょう

<label for="username">ユーザー名: (3-16 文字)</label><input   name="username"  type="text"  value="Sasha"  pattern="\w{3,16}"  required /><label for="pin">PIN: (4 桁)</label><input name="pin" type="password" pattern="\d{4,4}" required />

label {  display: block;  margin-top: 1em;}input:valid {  background-color: palegreen;}input:invalid {  background-color: lightpink;}

概要

pattern 属性はtext,tel,email,url,password,search の入力型の属性です。

pattern 属性は、制約検証を通過させるために、入力のvalue が一致するべき正規表現です。これは有効な JavaScript の正規表現でなければならず、RegExp 型で使用されたり、正規表現ガイドで説明されているものと同じものです。

パターンの正規表現は'v' フラグでコンパイルされます。これは正規表現をunicode 対応にし、文字クラスの解釈方法も変更します。これにより、文字クラスの設定には交差と減算の処理が可能になり、] と\ に加え、続く文字がリテラル文字(,),[,{,},/,-,| である場合は、\ バックスラッシュを使用してエスケープする必要があります。 2023 年半ば以前は、代わりに'u' フラグが指定されていました。古いコードを更新する場合は、unicodeSets のリファレンスを参照してください。

パターンの正規表現は、部分文字列に一致させるのではなく、入力のvalue 全体に一致させる必要があります。パターンの始めに^(?: が、終わりに)$ が含まれているかのように扱われます。

パターンテキストの周りにはスラッシュを指定しないでください。属性値が存在しないか、空文字列か、不正な場合は、正規表現は適用されません。

pattern 属性に対応している入力型の中には、特にemail およびurl 入力型のように、一致しなければならない期待値の構文を持っているものがあります。 pattern 属性が存在せず、値がその値型の期待される構文と一致しない場合、ValidityState オブジェクトの読み取り専用のtypeMismatch プロパティが true になります。

制約検証

入力の値が空文字列でなく、正規表現全体に一致しない場合、ValidityState オブジェクトのpatternMismatch プロパティがtrue になって報告される制約違反が存在することになります。

ユーザビリティとアクセシビリティの考慮

コントロールにpattern 属性がある場合、title 属性が使われていれば、そのパターンを説明しなければなりません。ユーザーエージェントは、制約の検証中に title のコンテンツを、パターンが一致しないことをユーザーに指示するために使用することができますブラウザーによっては、タイトルを持つ要素の上にポインターを置いたときにツールチップを表示しますが、キーボードのみのユーザーやタッチのみのユーザーは除外されてしまいます。これが、どのようにコントロールに記入すれば要件に合うかをユーザーに知らせる情報を含める必要がある理由の一つです。

多くのユーザーエージェントはtitle 属性をアクセシビリティのある方法で公開していないため、テキストコンテンツの視覚的な表示のためだけにtitle属性を頼ることは推奨されません。ブラウザーによっては、タイトルのある要素にカーソルを合わせるとツールチップを表示させるものもありますが、キーボードのみのユーザーやタッチのみのユーザーを除外することになります。これは、要求に一致するように制御する方法をユーザーに知らせる情報を記載しなければならないいくつかの理由の一つです。

一部のブラウザーではtitle を使用してエラーメッセージを表示していますが、ブラウザーはポインターを当てたときにもタイトルをテキストとして表示することがあり、エラーが発生していない状況でも表示されることがあるので、エラーが発生したかのような言葉を使用しないように注意してください。

例

電話番号の照合

以下のものを考えてみてください。

<p>  <label>    電話番号を (123) - 456 - 7890 の形で入力してください (<input      name="tel1"      type="tel"      pattern="[0-9]{3}"      placeholder="###"      aria-label="3 桁のエリアコード"      size="2" />) -    <input      name="tel2"      type="tel"      pattern="[0-9]{3}"      placeholder="###"      aria-label="3 桁の接頭辞"      size="2" />    -    <input      name="tel3"      type="tel"      pattern="[0-9]{4}"      placeholder="####"      aria-label="4 桁の番号"      size="3" />  </label></p>

ここでは北米の電話番号を示す 3 つの部分があり、電話番号の 3 つの構成要素すべてを含む暗黙のラベルがありますが、それぞれ 3 桁、3 桁、4 桁でpattern 属性によってそれぞれ設定されています。

値が長すぎたり短すぎたり、数字ではない文字が含まれていたりすると、patternMismatch が true になります。true の場合、要素は CSS の:invalid 擬似クラスに一致します。

input:invalid {  border: red solid 3px;}

代わりにminlength とmaxlength 属性を用いた場合、validityState.tooLong またはvalidityState.tooShort が true になります。

パターンの指定

pattern 属性を使用すると、入力された値が有効とみなされるために一致しなければならない正規表現を指定することができます（正規表現を使用して入力を検証する簡単な集中講座は、正規表現での検証を参照してください）。

以下の例では、値を 4-8 文字に制限し、小文字のみを含むことを要求しています。

<form>  <div>    <label for="uname">ユーザー名を選択してください: </label>    <input      type="text"           name="name"      required      size="45"      pattern="[a-z]{4,8}"      title="4 から 8 文字の英小文字" />    <span></span>    <p>ユーザー名は小文字で 4-8 文字の長さである必要があります。</p>  </div>  <div>    <button>送信</button>  </div></form>

div {  margin-bottom: 10px;  position: relative;}p {  font-size: 80%;  color: #999;}input + span {  padding-right: 30px;}input:invalid + span::after {  position: absolute;  content: "✖";  padding-left: 5px;}input:valid + span::after {  position: absolute;  content: "✓";  padding-left: 5px;}

これは次のように表示されます。

仕様書

ブラウザーの互換性

関連情報

• 制約検証
• フォーム: データフォーム検証
• 正規表現