configuration - アプリケーション構成

アプリケーションレイアウトの構造を制御します。

カテゴリ

basics

構文

<xe:this.configuration>
	<xe:applicationConfiguration attributes>content</xe:applicationConfiguration> |
	<xe:oneuiApplication attributes>content</xe:oneuiApplication>
</xe:this.configuration>
表 1. xe:applicationConfiguration と xe:oneuiApplication のプロパティ>
プロパティ 説明
banner="true|false" バナーを表示するかどうか。デフォルトは true です。 バナーはレイアウト領域の最上部に表示されます。バナーには、アプリケーションのロゴ、他のアプリケーションリンク、ログインリンクが含まれます。 
<xe:this.bannerApplicationLinks>nodes
</xe:this.bannerApplicationLinks>
 バナー内のアプリケーションリンク。nodes のコンテンツについては、treeNodes を参照してください。 
<xe:this.bannerUtilityLinks>nodes
</xe:this.bannerUtilityLinks>
 バナー内のユーティリティリンク。nodes のコンテンツについては、treeNodes を参照してください。
defaultNavigationPath="path" デフォルトのナビゲーションパス。
footer="true|false" フッターを表示するかどうか。デフォルトは true です。 フッターはレイアウト領域の最下部に表示されます。フッターには、フッターリンクが含まれます。レイアウト領域の外側にフッターコンテンツを配置するには、「mastfooter」を参照してください。 
<xe:this.footerLinks>nodes
</xe:this.footerLinks>
 フッター内のリンク。nodes のコンテンツについては、treeNodes を参照してください。 複数のリンクまたはリンクグループを追加できます。リンクは縦に表示され、グループは横に表示されます。
leftColumnLabel="text" ユーザー補助機能ラベルのアイコンの説明テキスト。
legal="true|false" リーガルバーを表示するかどうか。デフォルトは true です。 リーガルバーはフッター領域の下に表示されます。リーガルバーには、リーガルロゴとテキストが含まれます。
legalLogo="image" リーガルバー上のイメージのパス名。このイメージには、コンテンツに対する著作権を保有する組織のロゴを使用してください。
legalLogoAlt="text" リーガルロゴイメージの代替テキスト。
legalLogoClass="class(es)" リーガルロゴに適用する CSS スタイルクラス。CSS イメージのスプライトに使用します。
legalLogoHeight="30px|50%|10em|auto|inherit" リーガルロゴイメージの高さ。これを設定すると、ブラウザのパフォーマンスが若干改善します。
legalLogoStyle="style(s)" リーガルロゴに適用する CSS スタイル。
legalLogoWidth="50%|30px|10em|2cm|auto|inherit" リーガルロゴイメージの幅。これを設定すると、ブラウザのパフォーマンスが若干改善します。
legalText="text" リーガルバーに表示されるテキスト。著作権、商標、ライセンス情報に関するテキストを使用してください。
loaded="true|false" ページのロード時に、タグインスタンスを作成するかどうか。 デフォルトは true です。
mastFooter="true|false" マストフッターを表示するかどうか。デフォルトは true です。 マストフッターは、以下のプロパティを持つファセットとして、レイアウト領域の後に表示されます。
mastHeader="true|false" マストヘッダーを表示するかどうか。デフォルトは true です。 マストヘッダーは、以下のプロパティを持つファセットとして、レイアウト領域の前に表示されます。
navigationPath="path" ナビゲーションパス。
placeBar="true|false" プレースバーを表示するかどうか。デフォルトは true です。 プレースバーは、メインコンテンツ領域のすぐ上に表示されます。プレースバーには、プレースバー名とアクションが含まれます。 
<xe:this.placeBarActions>nodes
</xe:this.placeBarActions>
 プレースバー上のリンク。nodes のコンテンツについては、treeNodes を参照してください。 リンクは、プレースバーの末尾にボタンとして表示されます。
placeBarName="text" プレースバー上のテキスト。
placeBarLabel="text" ユーザー補助機能ラベルのアイコンの説明テキスト。
productLogo="image" タイトルの上に表示される製品ロゴのパス名。
productLogoAlt="text" 製品ロゴイメージの代替テキスト。
productLogoClass="class(es)" 製品ロゴに適用する CSS スタイルクラス。CSS イメージのスプライトに使用します。
productLogoHeight="30px|50%|10em|auto|inherit" 製品ロゴイメージの高さ。これを設定すると、ブラウザのパフォーマンスが若干改善します。
productLogoStyle="style(s)" 製品ロゴに適用する CSS スタイル。
productLogoWidth="50%|30px|10em|2cm|auto|inherit" 製品ロゴイメージの幅。これを設定すると、ブラウザのパフォーマンスが若干改善します。
rightColumnLabel="text" ユーザー補助機能ラベルのアイコンの説明テキスト。 
<xe:this.searchBar>
	<xe:appSearchBar attributes>
		content
	</xe:appSearchBar
</xe:this.searchBar>
 以下のプロパティを持つ xe:appSearchBar コントロール。
  • inactiveText - 非アクティブな検索ボックスのテキスト。
  • inputTitle - アクセシビリティタイトル。
  • legend - 検索オプションとキーワードコントロールの凡例。
  • loaded - ページのロード時にタグインスタンスを作成するかどうか。
  • options - 検索コンボボックスのオプション。ノードのコンテンツについては、「treeNodes」を参照してください。
  • optionsParam - URL の照会部分において、選択された検索オプションを示すパラメータの名前。
  • pageName - 検索結果のページの名前。
  • queryParam - URL の照会部分において検索値を示すパラメータの名前。デフォルトは search です。
  • rendered - 検索バーをレンダリングするかどうか。デフォルトでは、アプリケーションが索引付けされている場合にのみレンダリングします。
  • scopeTitle - 検索オプションのアクセシビリティタイトル。
titleBar="true|false" タイトルバーを表示するかどうか。デフォルトは true です。 タイトルバーはプレースバーの上に表示されます。タイトルバーには、タイトルバー名とタブが含まれます。
titleBarName="text" タイトルバー上のテキスト。
titleBarLabel="text" ユーザー補助機能ラベルのアイコンの説明テキスト。 
<xe:this.titleBarTabs>nodes
</xe:this.titleBarTabs>
 タイトルバー上のリンク。nodes のコンテンツについては、treeNodes を参照してください。 リンクはナビゲーションタブとして表示されます。

使用法

設計モードで、[すべてのプロパティ] を クリックし、[basics] の下で [configuration] を 探します。

例

以下に示すカスタムコントロールは、oneuiApplication 構成を使用してアプリケーションレイアウトを定義しています。 この構成は、左 (facet_1) 列と中央 (facet_2) 列に編集可能領域を設定します。右列は使用されません。
<?xml version="1.0" encoding="UTF-8"?>
<xp:view xmlns:xp="http://www.ibm.com/xsp/core" xmlns:xe="http://www.ibm.com/xsp/coreex">
	<xe:applicationLayout id="applicationLayout1">
		<xp:callback facetName="facet_2" id="callback2"></xp:callback>
		<xp:this.facets><xp:callback facetName="facet_1" id="callback1"
			xp:key="LeftColumn"></xp:callback></xp:this.facets>
		<xe:this.configuration>
			<xe:oneuiApplication
				placeBarName="Welcome to the application"
				productLogo="/xpagesui-logo.jpg" productLogoAlt="XPages UI logo"
				productLogoHeight="50%">
				<xe:this.footerLinks>
					<xe:basicContainerNode>
						<xe:this.children>
							<xe:basicLeafNode label="IBM"
								href="http://www.ibm.com">
							</xe:basicLeafNode>
							<xe:basicLeafNode label="Google"
								href="http://www.google.com">
							</xe:basicLeafNode>
						</xe:this.children>
					</xe:basicContainerNode>
				</xe:this.footerLinks>
				<xe:this.titleBarTabs>
					<xe:pageTreeNode label="main" page="/main.xsp"></xe:pageTreeNode>
					<xe:pageTreeNode label="mainview"
						page="/mainview.xsp">
					</xe:pageTreeNode>
				</xe:this.titleBarTabs>
			</xe:oneuiApplication>
		</xe:this.configuration>
	</xe:applicationLayout>
</xp:view>
親トピック: プロパティの参照 (拡張ライブラリ)