button - ボタン

ユーザーがクリックすることによりアクションを実行できるボタンを表示します。

カテゴリ

コアコントロール

構文

<xp:button attributes>content</xp:button>

表 1. 必須プロパティ
プロパティ	説明
id	デフォルトは `button1`、`button2` などです。
value	ボタンのラベルを指定します。
eventHandler	ボタンがクリックされたときのアクションを指定します。「使用法」セクションを参照してください。

表 2. すべてのプロパティ
カテゴリ	プロパティ
アクセシビリティ	accesskey、iconAlt、role、tabindex、title
basics	attrs、binding、dir、disabled、disableValidators、execId、execMode、icon、id、lang、loaded、navigate、refreshId、refreshMode、rendered、rendererType、save、type、value
dojo	dojoAttributes、dojoType
イベント	action、actionListener、actionListeners、immediate、onblur、onclick、ondblclick、onfocus、onkeydown、onkeypress、onkeyup、onmousedown、onmousemove、onmouseout、onmouseover、onmouseup
styling	disableTheme、outerStyleClass、 style、styleClass、 themeId

使用法

実行時に、ボタンがページに表示されます。ユーザーはこのボタンをクリックできます。

ボタンには次の 3 つのタイプがあります。

[ボタン] (デフォルト) は、作成したイベントハンドラに対応します (onclick など)。アクセシビリティに準拠するために、value プロパティには、実行されるアクションを記述する必要があります。
[送信] で、データが保存され、ページが閉じられます。アクセシビリティに準拠するためには、value プロパティは Submit でなければなりません。
[キャンセル] で、ページが閉じられます。アクセシビリティに準拠するためには、value プロパティは Cancel でなければなりません。

ページが閉じられたとき、次にロードされるページは、UI の [次頁 (完了または取り消し)] になるページの navigationRules プロパティによって決定されます。

UI でのボタンのタイプを設定するには、[プロパティ] の下の [ボタン] をクリックして、[ボタンの種類] から選択します。生成された eventHandler プロパティには、以下の属性があります。手動で eventHandler プロパティを構成する場合は、以下の規則に従ってください。

ボタン	送信	キャンセル
`event=any`	`event="onclick"`	`event="onclick"`
`submit=any`	`submit="true"`	`submit="true"`
`refreshMode=any`	`refreshMode="complete"`	`refreshMode="complete"`
`immediate=any`	`immediate="false"`	`immediate="true"`
`save=any`	`save="true"`	`save="false"`
`action= シンプルアクションまたはイベントハンドラ`	`action=none`	`action=none`

例

下のボタンコントロールのタイプは、[送信] です。

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

下のボタンコントロールのタイプは、[キャンセル] です。

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

下のボタンコントロールのタイプは [ボタン] で、クリックされると、データの保存シンプルアクションが実行されます。

<xp:button id="button1" value="Save and Exit">
	<xp:eventHandler event="onclick" submit="true" refreshMode="complete">
		<xp:this.action>
			<xp:save name="/xpage2.xsp"></xp:save>
		</xp:this.action>
	</xp:eventHandler>
</xp:button>