validators - バリデータリスト

データ入力の要件を適用します。

カテゴリ

data

構文

<xp:this.validators>
	validator ...
</xp:this.validators>

ここで、validator は以下のいずれかです。

<xp:validateLength attributes>content</xp:validateLength>
<xp:validateRequired attributes>content</xp:validateRequired>

使用法

設計モードで、[プロパティ] の下にある [検証] タブをクリックするか、[すべてのプロパティ] をクリックして [data] の下で [validators] を探します。

含まれるプロパティ

バリデータには以下のプロパティがあり、これらは静的な値にすることも計算結果にすることもできます。

表 1. 含まれるプロパティ
ヘッダー	ヘッダー
`maximum="n"` ここで、`n` は `minimum` より大きい整数です。	(`validateLength`) 文字列入力の場合にユーザーが入力できる最大文字数。
`message="string"`	(`validateLength`、`validateRequired`) 検証に失敗した場合にユーザーに返すメッセージのテキスト。
`minimum="n"`	(`validateLength`) 文字列入力の場合にユーザーが入力できる最小文字数。

例

この編集ボックスコントロールは必須です。

<xp:inputText id="inputText1" value="#{document1.subject}"
	required="true">
	<xp:this.validators>
		<xp:validateRequired message="Subject is required"></xp:validateRequired>
	</xp:this.validators>
</xp:inputText>

この編集ボックスには最小長と最大長が設定されています。

<xp:inputText id="inputText1" value="#{document1.subject}">
	<xp:this.validators>
		<xp:validateLength minimum="1" maximum="8">
			<xp:this.message>
				<![CDATA[#{javascript:return "Invalid: " + this.validators.value}]]>
			</xp:this.message>
		</xp:validateLength>
	</xp:this.validators>
</xp:inputText>

この編集ボックスは必須であり、最大長が設定されています。

<xp:inputText id="inputText1" value="#{document1.subject}"
	required="true">
	<xp:this.validators>
		<xp:validateLength maximum="64"
			message="Subject cannot exceed 64 characters">
		</xp:validateLength>
		<xp:validateRequired message="Subject is required"></xp:validateRequired>
	</xp:this.validators>
</xp:inputText>