特定の入力フィールドにユーザーによって入力された値のフォーマット形式が指定されたパターンに一致しなければならないことを指定します。検証が失敗した場合は、このタグのボディが評価されます。

検証する input タグの clientvalidate 属性が「none」でないことを確認してください。input タグを含む form タグの clientvalidate 属性は「true」に設定してください。

コンテキスト

次のタグで有効です。

form

<domino:validatepattern
name="input tag name"
pattern="valid pattern for matching values"
message="message to display if validation fails"
msgkey="message bundle key"
bundle="name of .properties file bundle"
locale="<languageCode>_<countryCode>"
alert="true|false"
onalert="alert dialog box message"
debug="true|false"
onfailure="inline|exception"
time="true|false"
The HTML tag attributes listed below>

alert

true が指定され、クライアントサイドの検証が有効な場合 (form タグの clientvalidate 属性 = true) は、検証エラーが起こると、ポップアップ形式のアラートダイアログボックスが表示されます。ダイアログボックスの内容は、次の順番で行われる検索によって提供されます。

1) onalert 属性値

2) msgkey 属性値

3) message 属性値

4) このタグのボディ


デフォルトは false です。省略可能。

msgkey 属性が指定される場合に使用されるメッセージバンドルの名前。デフォルトの検索順番に従います。メッセージが見つからなかった場合は、デフォルトのリソースバンドル名は messages が使用されます。msgkey 属性の値を指定しない場合は、この属性の値も指定できません。省略可能。

適切なメッセージバンドル検索するために使用するロケール。指定した場合は、ブラウザが AcceptLang 文字列で指定するロケールに優先します。次の構文を使用します。"<languageCode>_<countryCode>"詳しくは、「ロケールコード」を参照してください。デフォルトでは、ブラウザの AcceptLang 文字列で指定される最初のロケールが使用されます。msgkey 属性の値を指定しない場合は、この属性の値も指定できません。省略可能。

検証が失敗した場合に、validatesummary タグが表示するメッセージ。この属性の内容は、パススルー HTML として扱われます。省略可能。

メッセージバンドルに関連付けられたキーの名前。省略可能。

検証を実行する input タグの名前。対応する input タグの name 属性と同じです。必須。

クライアントサイドの検証が失敗した場合に、アラートダイアログボックスに表示されるメッセージ。この属性に値を指定すると、alert 属性は自動的に true に設定されます。省略可能。

エントリに許可される構文を表す文字からなる文字列。「正規表現の構文」に示された文字が使用可能です。必須。

HTML 属性

次の標準 HTML タグの属性については、「共通の HTML タグ属性」を参照してください。

class

style

Characters

文字	定義
unicodeChar	任意の同一の Unicode 文字と一致します。
\	メタ文字 (「*」など) を引用します。
\\	1 つの「\」文字と一致します。
\0nnn	8 進数の文字と一致します。
\xhh	8 ビットの 16 進数の文字と一致します。
\uhhhh	16 ビットの 16 進数の文字と一致します。
\t	ASCII タブ文字と一致します。
\n	ASCII 改行文字と一致します。
\r	ASCII 復帰文字と一致します。
\f	ASCII 改ページ文字と一致します。

文字クラス

クラス	文字の種類
[abc]	単純な文字クラス
[a-zA-Z]	範囲を持つ文字クラス
[^abc]	否定文字クラス

標準 POSIX 文字クラス

クラス	文字の種類
[:alnum:]	英数字
[alpha:]	アルファベット
[:blank:]	スペースおよびタブ
[:cntrl:]	制御文字
[:digit:]	数値
[:graph;]	印刷可能だが表示されない文字 (スペースなど)
[:lower:]	小文字のアルファベット
[:print:]	印刷可能な文字 (制御文字でないもの)
[:punct:]	分離記号 (英字、数字、制御文字、スペース以外)
[:space:]	スペース (タブ、改行、復帰、スペースなど)
[:upper:]	大文字のアルファベット
[:xdigit:]	16 進数

標準 POSIX 形式以外の文字クラス

クラス	文字の種類
[:javastart:]	Java 言語識別子の始まり
[:javapart:]	Java 言語識別子の一部

定義済みクラス

クラス	定義
.	改行以外の任意の文字に一致します。
\w	英数字と「_」に一致します。
\W	英数字と「_」以外の文字に一致します。
\s	空白文字と一致します。
\S	空白文字以外の文字と一致します。
\d	数字と一致します。
\D	数字以外の文字と一致します。

境界一致

演算子	定義
^	行の始めにのみ一致します。
$	行の終わりにのみ一致します。
\b	単語の境界にのみ一致します。
\B	単語の途中にのみ一致します。

繰り返し

すべてのクロージャ演算子 (+, *, ?, {m,n}) は、デフォルトで欲張りです。つまり、全体的な一致が失敗することなく、できるだけ多くの文字列の要素と一致します。非欲張りクロージャでは、検索の際に文字列のわずかな要素に一致します。繰り返しを非欲張りにするには、「?」を後ろに置きます。{m,n} による繰り返しは、現在、非欲張りな繰り返しをサポートしていません。

欲張りな繰り返し

演算子	定義
A*	A と 0 回以上一致します (欲張り)。
A+	A と 1 回以上一致します (欲張り)。
A?	A と 0 または 1 回一致します (欲張り)。
A{n}	A と正確に n 回一致します (欲張り)。
A{n, }	A と少なくとも n 回一致します (欲張り)。
A{n,m}	A と少なくとも n 回一致しますが、m 回より多くは一致しません (欲張り)。

非欲張りな繰り返し

演算子	定義
A*?	A と 0 回以上一致します (非欲張り)。
A+?	A と 1 回以上一致します (非欲張り)。
A??	A と 0 または 1 回一致します (非欲張り)。

論理演算子

演算子	定義
AB	B が後ろにある A と一致します。
A|B	A または B と一致します。
(A)	部分正規表現グループ化に使用されます。

前方参照

「バックリファレンス」は、カッコ内の正義表現の内容を表します。正規表現内の最初の前方参照は \1 で表され、2 番目は \2 というように表されます。次の式は、n=n 形式 (0=0 または 2=2 など) の任意の文字列と一致します。

([0-9]+)=\1

演算子	定義
\1	最初のカッコ内の正規表現を前方参照します。
\2	2 番目のカッコ内の正規表現を前方参照します。
\3	3 番目のカッコ内の正規表現を前方参照します。
\4	4 番目のカッコ内の正規表現を前方参照します。
\5	5 番目のカッコ内の正規表現を前方参照します。
\6	6 番目のカッコ内の正規表現を前方参照します。
\7	7 番目のカッコ内の正規表現を前方参照します。
\8	8 番目のカッコ内の正規表現を前方参照します。
\9	9 番目のカッコ内の正規表現を前方参照します。

Domtags タグライブラリ

用語集