ファセットの理解

ファセットは、コントロール内に、さらに別のコントロールを配置するためのリージョンを定義します。

コントロールは、コントロールとファセットのコンテンツに応じて、ファセットをレンダリングする場合もあれば、しない場合もあります。

ファセットの特殊な使用法として、ビューでのページャの配置があります。ファセットの一般的な使用法としては、その他のコントロールにおけるパネルの配置があります。ここでは、ビューのサンプルソースコードを示します。 facets リージョンが、親コントロールの属性として記述されていること、および別のコントロールを含んでいることに注意してください。

<xp:viewPanel rows="30" id="viewPanel1">
	<xp:this.facets>
		<xp:pager partialRefresh="true" layout="Previous Group Next"
			xp:key="headerPager" id="pager1">
		</xp:pager>
	</xp:this.facets>
	<xp:this.data>
		<xp:dominoView var="view2" viewName="main"></xp:dominoView>
	</xp:this.data>
	<xp:viewColumn columnName="subject" id="viewColumn1">
		<xp:viewColumnHeader value="subject" id="viewColumnHeader1"></xp:viewColumnHeader>
	</xp:viewColumn>
	<xp:viewColumn columnName="fruit" id="viewColumn2">
		<xp:viewColumnHeader value="fruit" id="viewColumnHeader2"></xp:viewColumnHeader>
	</xp:viewColumn>
</xp:viewPanel>

xp:key の指定は、ファセットの成果物であり、別のコントロールのプロパティではありません。示されている値は、ビューでのページャに対応します。パネルの場合、east、west、south、north、southwest、southeast、northwest、northeast のいずれか 1 つの値を使用して、親コントロール内での別のコントロールの場所を指定します。

以下のサンプルコードには、2 つのリンク (Inbox と Outbox) と 1 つのイメージを表示するパネルが含まれています。最初のリンクは、onclick イベントを提供します。

<xp:viewPanel>
	<xp:this.facets>
		<xp:panel xp:key="west">
			<xp:link text="Inbox" >
				<xp:eventHandler event="onclick" submit="true">
					<xp:this.action>
					</xp:this.action>
				</xp:eventHandler>
			</xp:link>
			<xp:br/>
			<xp:link  text="Outbox" />
			<xp:br/>
			<xp:image id="viewPickerImage"
				value="/images/sampleViewPicker.gif" />
		</xp:panel>
	</xp:this.facets>
<xp:viewPanel>

ファセットは、設計モードでは表示されません。ファセットを直接作成および変更するには、ソースモードを使用する必要があります。