12.4.3 リージョンの編集
リージョン属性を編集して、ページの外観を変更します。
- リージョン属性の編集
ページ・デザイナでリージョン属性を編集します。 - リージョン位置の制御
「レイアウト」の「位置」属性を使用して、このリージョンのテンプレート位置を選択します。 - リージョンのヘッダーおよびフッターの指定
「ヘッダー」および「フッター」属性を編集して、追加のHTMLがリージョンの上下に配置されるように指定します。 - リージョン・キャッシュの有効化
リージョン・キャッシュを有効にして、条件を使用しないリストを含むリージョン、静的HTMLを含むリージョンなどの静的リージョンのパフォーマンスを向上させます。 - ユーザーによるページのカスタマイズの可能化
「カスタマイズ可能」属性を使用して、リージョンの表示属性をユーザーがカスタマイズできるかどうかを制御します。 - 静的リージョンIDの指定
カスタムJavaScriptまたはカスケード・スタイルシートの作成時に静的リージョンIDを指定すると有用です。 - リージョン・イメージの追加
「リージョン・イメージ」および「イメージ・タグ属性」を使用して、リージョンの左上にイメージを追加します。 - リージョン表示セレクタの作成
リージョン表示セレクタ・リージョンを作成して、ページ上のリージョンごとに表示コントロールと非表示コントロールを含め、現在のリージョンを「リージョン表示セレクタ」に含めます。
親トピック: リージョンの管理
12.4.3.1 リージョン属性の編集
ページ・デザイナでリージョン属性を編集します。
リージョン属性を編集するには:
- 「レンダリング」タブで、リージョンを選択します。
プロパティ・エディタの右ペインにある「リージョン」タブに属性が表示されます。
グループまたは属性を検索するには:
-
グループまたは属性の検索: 「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。デフォルトの表示に戻すには、キーワードを削除します。
-
「グループに移動」の使用- 「グループに移動」をクリックして、グループを選択します。デフォルトの表示に戻すには、「グループに移動」を再度クリックして、「すべて開く」を選択します。
-
親トピック: リージョンの編集
12.4.3.2 リージョン位置の制御
「レイアウト」の「位置」属性を使用して、このリージョンのテンプレート位置を選択します。
「レイアウト」の「位置」属性を構成して、リージョンの表示に使用する位置を選択します。位置は、適切なページまたはリージョン・テンプレート位置から導出されます。
親トピック: リージョンの編集
12.4.3.3 リージョンのヘッダーおよびフッターの指定
「ヘッダー」および「フッター」属性を編集して、追加のHTMLがリージョンの上下に配置されるように指定します。
「ヘッダー・テキスト」属性に、#BODY#コンテンツの上にあるリージョンの上部に表示するHTMLテキストを入力します。すべてのレポート・リージョンで、置換文字列#TIMING#:はリージョンのレンダリングにかかる経過時間(秒)を表示できます。この置換文字列はデバッグに使用できます。
「フッター・テキスト」属性に、リージョン・テンプレートの#BODY#の後にボディ・コンテンツの直後に表示されるリージョン・フッターを入力します。ショートカットと置換文字列#TIMING#を使用して、リージョンのレンダリングにかかる時間を表示できます。
クラシック・レポート・リージョンの場合、リージョン・フッターで次の置換文字列がサポートされています。
-
#ROWS_FETCHED#は、Oracle APEXレポート・エンジンによってフェッチされた行数(ページ・サイズ)を示します。これらの置換文字列を使用して、カスタマイズされたメッセージをユーザーに表示できます。たとえば:Fetched #ROWS_FETCHED# rows in #TIMING# seconds -
#TOTAL_ROWS#: レポートに使用されたSQL問合せを満たす行の合計数を表示できます。たとえば:Z in rows X - Y of Z -
#FIRST_ROW_FETCHED#および#LAST_ROW_FETCHED#:表示される行の範囲を表示できます。たとえば:Row(s)#FIRST_ROW_FETCHED# through #LAST_ROW_FETCHED# of #ROWS_FETCHED# displayed
親トピック: リージョンの編集
12.4.3.4 リージョン・キャッシュの有効化
リージョン・キャッシュを有効にして、条件を使用しないリストを含むリージョン、静的HTMLを含むリージョンなどの静的リージョンのパフォーマンスを向上させます。
リージョン・キャッシュを有効にすると、APEXエンジンによって、リージョンを動的にレンダリングするかわりにキャッシュされた(または格納された)リポジトリからリージョンをレンダリングします。実際のセッション識別子はキャッシュされないことに注意してください。かわりに、APEXエンジンでは、&SESSION.置換文字列がキャッシュされ、キャッシュされたリージョンをレンダリングしたカレント・セッションが表示時に代入されます。たとえば、リージョンにリンクが含まれ、リンクにセッションが含まれる場合、リンクがすべてのセッションで動作するようにするため、完全なセッションはキャッシュされません。
APEXエンジンは、リージョンが定義した条件を満たす場合にのみキャッシュからレンダリングします。また、リージョンは、ユーザーまたはキャッシュされた独立したユーザーに対してのみキャッシュできます。
リージョン・キャッシュを有効化するには:
親トピック: リージョンの編集
12.4.3.5 ユーザーによるページのカスタマイズの可能化
「カスタマイズ可能」属性を使用して、リージョンの表示属性をユーザーがカスタマイズできるかどうかを制御します。
この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに#CUSTOMIZE#置換文字列を含める必要があります。
エンド・ユーザーによるカスタマイズが1つ以上のリージョンでサポートされる場合、「カスタマイズ」リンクがページ・テンプレートで#CUSTOMIZE#置換文字列を含めた場所に表示されます。このリンクをクリックするとウィンドウが表示され、ユーザーは、ページのリージョンを表示または非表示にできます。
エンド・ユーザーのカスタマイズを有効化するには:
関連項目:
親トピック: リージョンの編集
12.4.3.6 静的リージョンIDの指定
カスタムJavaScriptまたはカスケード・スタイルシートの作成時に静的リージョンIDを指定すると有用です。
リージョンの編集ページの「静的ID」属性を使用して、リージョンを一意に識別できます。リージョン・テンプレート、ヘッダー、フッターまたはボディの#REGION_STATIC_ID#置換文字列を使用してリージョンを参照できます。
静的リージョンIDを含めるには、HTML要素IDとしてリージョン・コンテナ・オブジェクト(表またはDIV)に割り当てます。HTML要素のIDはページ全体で一意である必要があります。たとえば、ページHTMLを有効にしておくため、ボタンとリージョンのIDを同じにすることはできません。
静的リージョンIDを指定するには:
親トピック: リージョンの編集
12.4.3.7 リージョン・イメージの追加
「リージョン・イメージ」および「イメージ・タグ属性」を使用して、リージョンの左上にイメージを追加します。
リージョン・イメージを追加するには:
親トピック: リージョンの編集
12.4.3.8 リージョン表示セレクタの作成
リージョン表示セレクタ・リージョンを作成して、ページ上のリージョンごとに表示コントロールと非表示コントロールを含め、現在のリージョンを「リージョン表示セレクタ」に含めます。
リージョン表示セレクタを作成するには:
親トピック: リージョンの編集