rules - リダイレクトルール

ページを開くためのルールを指定します。

カテゴリ

basics

構文

<xe:this.rules>
	<xe:redirectPhoneRule attributes>content</xe:redirectPhoneRule> |
	<xe:redirectTabletRule attributes>content</xe:redirectTabletRule> |
	<xe:redirectHeaderRule attributes>content</xe:redirectHeaderRule> |
	<xe:redirectCustomRule attributes>content</xe:redirectCustomRule>
	...
</xe:this.rules>

表 1. 各ルールのプロパティ
プロパティ	説明
`disableRequestParams="true\|false"`	要求パラメータをターゲットページの URL にコピーする処理を無効化します。デフォルトは false。
`<xe:this.extraParams> <xp:parameter name="param" value="val" loaded="true\|false"> </xp:parameter> ... </xe:this.extraParams>`	ターゲット URL に付加される追加パラメータ。
`header="User-Agent \| Accept"`	(`xe:redirectHeaderRule` のみ) `headerPattern` と照合する要求ヘッダー。デフォルトは `User-Agent` です。
`headerPattern="regexp"`	(`xe:redirectHeaderRule` のみ) `type` が `custom` である場合の、正規表現で表された要求ヘッダーパターン。
`loaded="true\|false"`	ページのロード時に、タグインスタンスを作成するかどうか。デフォルトは true です。
`url="page.xsp"`	ターゲット URL。通常は拡張子 `.xsp` が付いた XPage の名前。
`urlHash="hash"`	モバイルページを指定するために `url` に付加される、`#` というプレフィックスが付いたストリング (例: `#document`、`#topic`)。

使用法

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

最初に一致したルールによってターゲットページが決まります。

redirectPhoneRule (Redirect Phone Rule) ブラウザがモバイルデバイス上にある場合、別のページにリダイレクトします。
redirectTabletRule (Redirect Tablet Rule) ブラウザがタブレットデバイス上にある場合、別のページにリダイレクトします。
redirectHeaderRule (Redirect Header Rule) ヘッダーが指定したパターンに一致する場合、別のページにリダイレクトします。
redirectCustomRule (Redirect Custom Rule) redirect プロパティが true を評価する場合、別のページにリダイレクトします。

例

以下の例は、要求側のデバイスが携帯電話またはタブレットの場合に、現在のページを mobile.xsp#document にリダイレクトします。

<xe:redirect>
	<xe:this.rules>
		<xe:redirectPhoneRule
			url="mobile.xsp" urlHash="document" disableRequestParams="false">
		</xe:redirectPhoneRule>
		<xe:redirectTabletRule
			url="mobile.xsp" urlHash="document" disableRequestParams="false">
		</xe:redirectTabletRule>
	</xe:this.rules>
</xe:redirect>