eventHandler - イベントハンドラ (コントロール)

コントロールのクリックなどのユーザーアクションに応答します。

カテゴリ

その他のコントロール

構文

<xp:eventHandler attributes>content</xp:eventHandler>

表 1. 必須プロパティ
プロパティ	説明
save	フォーム関連のデータを保存するか保存しないかを指定します。これは、`Cancel` のタイプのボタンの場合、false でなければなりません。
submit	サーバーに要求を送信し、サーバーから応答を受信する場合、これは true です。クライアントハンドラは、false を返すことによって要求の送信をキャンセルできます。
refreshMode	ページの更新が完全か部分的か、実行しないかを指定します。
immediate	これは、`Cancel` のタイプのボタンの場合、true でなければなりません。

表 2. すべてのプロパティ
カテゴリ	プロパティ
basics	binding、disableValidators、event、execId、execMode、handlers、id、loaded、navigate、refreshId、refreshMode、rendered、rendererType、save、submit、value
data	parameters
イベント	action、actionListener、actionListeners、immediate、onComplete、onError、onStart、script
styling	disableTheme、themeId

使用法

イベントの理解を参照してください。

例

下の例は、Submit のタイプのボタンコントロールです。

<xp:button value="submit" id="button1">
	<xp:eventHandler event="onclick" submit="true"
		refreshMode="complete" immediate="false" save="true">
	</xp:eventHandler>
</xp:button>

下の例は、Cancel のタイプのボタンコントロールです。

<xp:button value="cancel" id="button2">
	<xp:eventHandler event="onclick" submit="true"
		refreshMode="complete" immediate="true" save="false">
	</xp:eventHandler>
</xp:button>

下の例は、ユーザーがコーディングした onclick イベントを持つボタンコントロールです。

<xp:button value="set username" id="button3">
	<xp:eventHandler event="onclick" submit="true" refreshMode="complete">
		<xp:this.action>
			<![CDATA[#{javascript:getComponent("inputText2").setValue(session.getCommonUserName())}]]>
		</xp:this.action>
	</xp:eventHandler>
</xp:button>