Previous Next JavaScript must be enabled to correctly display this content

## 12.4.3 Editing Regions

Alter the appearance of a page by editing Region attributes.

Note:

Edit the region attributes in the Accessibility group to help users of assistive technology to better navigate APEX pages. To learn more, see Regions in Oracle APEX Licensing Information User Manual.

- Editing Region Attributes
  Edit Region attributes in Page Designer.
- Updating the Region Name or Title
  Identify a region by editing the Identification, Name and Title attributes.
- Controlling Region Positioning
  Use the Layout, Position attribute to select the template position for this region.
- Specifying a Region Header and Footer
  Edit the Header and Footer attributes to specify additional HTML to be placed above and below a region.
- Enabling Region Caching
  Enable region caching to improve the performance of static regions such as regions containing lists that do not use conditions or regions containing static HTML.
- Enabling Users to Customize a Page
  Use the Customizable attribute to control whether display attributes in a region can be customized by users.
- Configuring Advanced Region Attributes
  Configure Advanced attributes to specify a region HTML DOM ID, define Custom Attributes, edit the Static ID, create a Region Display Selector, or exclude the region title from translations.
- Adding a Region Image
  Use Region Image and Image Tag Attributes to add an image to the upper left side of a region.
- Creating a Region Display Selector
  Create a Region Display Selector region to include show and hide controls for each region on a page. to include the current region in the Region Display Selector.

Parent topic: Managing Regions

### 12.4.3.1 Editing Region Attributes

Edit Region attributes in Page Designer.

To edit region attributes:

1. View the page in Page Designer:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Select a page.
   Page Designer appears.
2. In the Rendering tab, select the region.

   The Property Editor displays attributes in the Region tab in the right pane.

   Description of the illustration pg_edit_region.png

   To find a group or attribute:

   - Search for the group or attribute - Enter keywords in the Filter Properties field. The Property Editor displays the group or attributes. To return to the default display, delete the keywords.

   - Use Go to Group - Click Go to Group and select the group. To return the default display, click Go to Group again and select Expand All.

3. Edit the Region attributes in the Property Editor.

   To view help for an attribute, select the attribute in the Property Editor and click the Help tab in the central pane.

4. To save your changes click Save. To save and run the page, click Save and Run Page.

See Also:

Right Pane of Page Designer (Property Editor)

Parent topic: Editing Regions

### 12.4.3.2 Updating the Region Name or Title

Identify a region by editing the Identification, Name and Title attributes.

Use the Identification, Name attribute to specify the region name. The Name attribute is required and used by Page Designer to identify the region in the Rendering and Layout tabs.

Use the Identification, Title attribute to specify a region title. The region title only displays at runtime if it is defined in the region template. If the Title attribute is empty, the APEX engine uses the region Name at runtime.

Parent topic: Editing Regions

### 12.4.3.3 Controlling Region Positioning

Use the Layout, Position attribute to select the template position for this region.

Configure the Layout, Position attribute to select the position used to display a region. The positions are derived from the appropriate page or region template positions.

Parent topic: Editing Regions

### 12.4.3.4 Specifying a Region Header and Footer

Edit the Header and Footer attributes to specify additional HTML to be placed above and below a region.

In the Header Text attribute, enter HTML text to display at the top of the region above the `#BODY#` content.

In the Footer Text attribute, enter a region footer that displays directly after the body content, after `#BODY#` in the region template. You may use shortcuts as well as the substitution string `#TIMING#` which displays the time in seconds it took to render the region. You can use this substitution string for debugging purposes.

For classic report regions, the region footer supports the following substitution strings:

- `#ROWS_FETCHED#` shows the number of rows fetched by the Oracle APEX reporting engine (the page size). You can use these substitution strings to display customized messages to the user. For example:

  `Fetched #ROWS_FETCHED# rows in #TIMING# seconds`

- `#TOTAL_ROWS#` displays the total number of rows that satisfy a SQL query used for a report. For example:

  `Z in rows X - Y of Z`

- `#FIRST_ROW_FETCHED#` and `#LAST_ROW_FETCHED#` display the range of rows displayed. For example:

  `Row(s)#FIRST_ROW_FETCHED# through #LAST_ROW_FETCHED# of #ROWS_FETCHED# displayed`

Parent topic: Editing Regions

### 12.4.3.5 Enabling Region Caching

Enable region caching to improve the performance of static regions such as regions containing lists that do not use conditions or regions containing static HTML.

When you enable region caching, the APEX engine renders a region from a cached (or stored) repository instead of rendering it dynamically. Keep in mind that the actual session identifiers are not cached. Instead, the APEX engine caches a `&SESSION.` substitution string and the current session rendering the cached region is substituted on display. For example, if a region contains a link and the link includes a session, the exact session is not cached to ensure that the links works for all sessions.

The APEX engine only renders a region from cache if it meets the defined condition. Additionally, regions can be cached specific to a user or cached independent of a user.

To enable region caching:

1. View the page in Page Designer:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Select a page.
   Page Designer appears.
2. In the Rendering tab, select the region.

   The Property Editor displays attributes in the Region tab in the right pane.

3. Server Cache, Caching - Select one of the following:
   - Disabled - Content is not cached and computed for each request.
   - Enabled - Content is cached and utilized by all users.
   - Cached by User - Content is cached specifically for each user.
   - Cache by Session - Content is cached specifically for each session.
4. Click Save.

See Also:

Managing Page and Region Caching in Oracle APEX Administration Guide

Parent topic: Editing Regions

### 12.4.3.6 Enabling Users to Customize a Page

Use the Customizable attribute to control whether display attributes in a region can be customized by users.

To use this feature, you must include the `#CUSTOMIZE#` substitution string in the Header, Body, or Footer section of the page template.

If at least one region supports end-user customization, a Customize link appears wherever you include the `#CUSTOMIZE#` substitution string in the page template. When users click this link, a window appears, enabling them to display or hide regions on the page.

To enable end user customization:

1. View the page in Page Designer:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Select a page.
   Page Designer appears.
2. Select the region in the Rendering tab or the Layout tab.

   The Property Editor displays attributes in the Region tab in the right pane.

3. Customization, Customizable - Select one of the following:
   - Not Customizable By End Users
   - Customizable and Not Shown By Default
   - Customizable and Shown By Default
4. To save your changes click Save. To save and run the page, click Save and Run Page.

See Also:

Creating Custom Themes

Parent topic: Editing Regions

### 12.4.3.7 Configuring Advanced Region Attributes

Configure Advanced attributes to specify a region HTML DOM ID, define Custom Attributes, edit the Static ID, create a Region Display Selector, or exclude the region title from translations.

To edit Advanced region attributes:

1. View the page in Page Designer:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Select a page.
   Page Designer appears.
2. Select the region in the Rendering tab or the Layout tab.

   The Property Editor displays attributes in the Region tab in the right pane.

3. Advanced, HTML DOM ID - Enter the HTML DOM ID for this region. HTML DOM ID is useful when creating custom JavaScript or cascading style sheets. You can then reference the region using the `#DOM_ID#` substitution string in a region templates, the header, the footer, or the body. If this attribute is not defined, the region generates an internal ID.

   Tip:

   The region template must include the `#DOM_ID#` substitution string, in order for the region to utilize the HTML DOM ID entered.

   Note:

   The Region, Static ID attribute has been renamed HTML DOM ID. This terminology change better reflect its purpose in the DOM and avoids overlapping with the newly introduced Static ID used in APEXlang application exports. The substitution string `#REGION_STATIC_ID#` has been deprecated and replaced with `#DOM_ID#`. Oracle still supports `#REGION_STATIC_ID#` for backward compatibility, but recommends using `#DOM_ID#` for new development.
4. Advanced, Custom Attributes - Enter the value substituted into region attributes. Region templates that contain the substitution string `#REGION_ATTRIBUTES#` are substituted with this value.
5. Advanced, Static ID - Enter a unique Static ID to identify this component in API calls or refer to it in application export files.

   By default, this attribute is locked. To unlock it, click the Lock icon. If you change the Static ID, dependent components will retain their references, but any existing API calls using the old ID must be updated manually.

6. Advanced, Region Display Selector - Specify On if you want this region included in the Region Display Selector. This attribute is only utilized if a region type of Region Display Selector is defined and viewable on the page. See Creating a Region Display Selector.
7. Advanced, Exclude Title from Translation - Specify whether you want to exclude this title from translation. This attribute has no effect, except when translating the application into another language.
8. To save your changes click Save. To save and run the page, click Save and Run Page.

Parent topic: Editing Regions

### 12.4.3.8 Adding a Region Image

Use Region Image and Image Tag Attributes to add an image to the upper left side of a region.

Use the Region Image and Image Tag Attributes to add an image to the upper left side of a region.

To add a region image:

1. View the page in Page Designer:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Select a page.
   Page Designer appears.
2. Select the region in the Rendering tab or the Layout tab.

   The Property Editor displays attributes in the Region tab in the right pane.

3. Under Advanced, edit the following attributes:

   - Region Image - Enter a reference to an image that displays in the upper left of the region. There is no control over the table tag used to display this image.

   - Image Tag Attributes - Enter image tag attributes included in the image HTML. This can be used for attributes such as height, width or image ALT text (if the image is non-decorative).

     If no ALT is defined in the image tag attributes, APEX defaults to rendering the image as a decorative image, for example with an empty ALT tag.

4. To save your changes click Save. To save and run the page, click Save and Run Page.

Parent topic: Editing Regions

### 12.4.3.9 Creating a Region Display Selector

Create a Region Display Selector region to include show and hide controls for each region on a page. to include the current region in the Region Display Selector.

When a user clicks on a region name included in the Region Display Selector, only the selected region shows and all other listed regions are hidden. The first entry within the Region Display Selector is Show All, which enables the user to show all of the available regions rather than only the previously selected region.

To create a Region Display Selector:

1. Create the page and regions to be included in the Region Page Selector.
2. For each region to be included in the selector, set the Region Display Selector attribute to On.
3. In the Gallery, right-click Region Display Selector region, select Add To, and select the appropriate location.

   Tip:

   You can also drag and drop from the Gallery. From the Gallery select the Region Display Selector region and drag it to the appropriate location in the Layout tab.

4. Edit the Region attributes in the Property Editor:
   1. In the Rendering tab (left pane), select the region.
      The Property Editor displays attributes in the Region tab. Attributes are organized in groups.
   2. Identification, Title - Enter a region title. The region title only displays when it is defined in the region template.
   3. Advanced, Region Display Selector - Select On if you want this region included in the Region Display Selector. This attribute is only utilized if a region type of Region Display Selector is defined and viewable on the page.
   4. Edit additional attributes as needed.

      To learn more about an attribute, select the attribute in the Property Editor and click the Help tab in the central pane.

5. Edit Attributes in the Property Editor:
   1. In the Rendering tab (left pane), select the region.
   2. In the Property Editor, select the Attributes tab.
   3. Settings, Mode - Select how Region Display Selector regions display on the page. Options include:

      - View Single Region - Show regions as tabs. Selecting a tab will make the corresponding region visible and hide the other selections.

      - Scroll Window - Always display all the regions on the page. Selecting a tab will scroll your window to the corresponding region.

   4. Settings, Display Region Icons - Region Display Selector tabs will include the icon and title associated with each region.
   5. Settings, Include 'Show All' - Prepend a "Show All" tab which, when selected, displays all regions on the page.
   6. Settings, Remember Last Selection - Select how the Region Display Selectors remember the tab selection on page load. Options include:
      - By User - Tab selection will always be remembered across all sessions unless intentionally reset.
      - By Session - Tab selection will be remembered for the duration of a single session. Once the session ends, the tab selection will be reset.
      - No - Tab selection will be reset to the first tab each time the page reloads.
6. To save your changes click Save. To save and run the page, click Save and Run Page.

Parent topic: Editing Regions