Common page attributes you may want to edit include the page name or title, header and footer text, and the selected authorization scheme.
Topics:
Component View Page Attributes page are divided into the following sections:
Topics:
Table 24-4 describes general attributes for the current page such as the page name, an optional alphanumeric alias, and associated page groups.
Table 24-4 Page Attributes: Name
Attributes | Description |
---|---|
Identifies the name of the current page for application developers. This name is used in numerous pages and reports, along with the page number and page title. |
|
Enter an alphanumeric alias for this page. This alias must be unique within the current application. For example, if you were working on page 1 of application 100, you could create an alias called f?p=100:home |
|
Identify the page group you would like to associate with this page. Page groups do not affect functionality, but help developers manage the pages within an application. To remove a page from a group, select No Group Assigned and click Apply Changes. See Also: "Creating Page Groups" |
Table 24-5 describes general display attributes for the current page such as the selected page template, standard tab set, title, and cursor focus.
Table 24-5 Page Attributes: Display Attributes
Attributes | Descriptions |
---|---|
Enter a title to display in the title bar of the browser window. The Application Express engine uses the title you specify here in place of the #TITLE# substitution string used in the page template. This title is inserted between the HTML tags <TITLE> and </TITLE>. |
|
Select a page mode. Options include:
See Also: "Creating Dialog Pages" |
|
Template options enable you to select a number of CSS customization settings to be applied to the current page template. Template options and their corresponding CSS classes are defined at the page template-level. To learn more about an attribute, see field-level Help. See Also: "Editing Themes" |
|
Enter additional CSS classes as space a delimited list which are substituted if the page template contains the substitution string #PAGE_CSS_CLASSES#. See Also: "Editing Themes" |
|
Specify the cursor focus. Available options include: |
|
Enter the Internet Media Type. An Internet Media Type is two-part identifier for file formats on the Internet. A Media Type is composed of at least two parts: a type, a subtype, and one or more optional parameters. This Media Type is used in the Content-Type HTTP header when rendering the page. The page-level Media type overrides the application-level media type. The default value for this attribute is |
Table 24-6 describes attributes that enable you to include JavaScript on the current page.
Table 24-6 JavaScript Attributes
Attribute | Description |
---|---|
Enter JavaScript file URLs for code to be loaded on this page. Each URL has to be written into a new line. If you provide a minified version of your file you can use the substitution string To view examples, see field-level Help. |
|
Enter JavaScript code (for example, functions or global variable declarations) for code to be used on this page. If the code is used on multiple pages, consider putting it into an external JavaScript file to avoid duplication. Code you enter here replaces the Note: Do not to include opening or closing script tags. Just include the JavaScript code. To reference a shortcut, use: "SHORTCUTNAME" |
|
Enter JavaScript code to execute when the page loads. The code is executed after the JavaScript code generated by Oracle Application Express. Code you enter here replaces the Note: Do not to add any opening or closing script tags, just the JavaScript code. |
Table 24-7 describes attributes that enable you to include Cascading Style Sheet (CSS) files on the current page.
Table 24-7 CSS Attributes
Attribute | Description |
---|---|
Enter Cascading Style Sheet file URLs to be loaded on this page. Each URL has to be written into a new line. If you provide a minified version of your file you can use the substitution string File URLs you enter here replace the Note: You do not need to include opening or closing link tags. Just include the file URL To view examples, see field-level Help. |
|
Enter Cascading Style Sheet code to be used on this page. If the code is used on multiple pages, consider putting it into an external file to avoid duplication and to leverage browser caching of static files. Code you enter here replaces the Note: Do not include opening or closing style tags. Just include the cascading style sheet code. To view examples, see field-level Help. |
Table 24-8 describes attributes for defining a page which displays as a dialog. These attributes only apply when the Page Mode is set to Modal Dialog or Non-Modal Dialog.
Tip:
These attributes overwrite similar settings defined at the page template-level. See "Dialog".
Table 24-8 Page Attributes: Dialog
Attribute | Description |
---|---|
Enter the width of the dialog, in pixels or a percentage. This setting overwrites the default dialog width specified at page template-level. For a page using a Desktop user interface, the value should be set in pixels, for example, 500. For a page using the jQuery Mobile Smartphone user interface, the value should be set in percent, for example, 80%. The substitution string |
|
Enter the height of the dialog in pixels, for example, 500. The substitution string |
|
Enter the maximum width of the dialog, in pixels. This setting will overwrite the default dialog maximum width specified at page template-level. For a page using the jQuery Mobile Smartphone user interface, the maximum width is 500.The substitution string |
|
Dialog support in Oracle Application Express varies depending on the page user interface: Desktop user interfaces use a jQuery UI dialog and Mobile user interface uses the jQuery Mobile dialog widget. Oracle Application Express supports the following subset of dialog attributes: height, width, and maximum width. The substitution string To learn more, see field-level Help. |
|
Enter additional CSS classes you wish to be applied to the dialog, as a space delimited list. For example: ui-dialog--wizard Any occurrence of the substitution string |
|
Select Yes if this dialog is opened by another dialog, and should reuse the same dialog window. For example, if this dialog is part of a multiple page dialog wizard, and you wish to reuse the dialog window for each step of the wizard. Select No if this dialog is opened by another dialog, and should be opened in a new dialog window. For example, when this dialog is modal, and you wish to open it within a parent modal dialog window. |
Table 24-9 describes attributes for defining the page header and page HTML body text.
Table 24-9 HTML Header Attributes
Attribute | Description |
---|---|
Enter text to replace the Note: JavaScript code or Cascading Style Sheets should be added to the dedicated JavaScript and CSS attributes. |
|
Enter text to be substituted in for your page template's |
Table 24-10 describes attributes for defining the header and footer text.
Select a condition type from the list that must be met in order for this page to render page items as a read-only. Not selecting a condition causes the page items to render normally. The read only condition is evaluated after executing the processes with a processing point of Before Header.
Tip:
If you want some page items (for example a search field) or all page items of a specific region to always render as enterable page items independent of how this condition evaluates, then set the Read Only condition of those regions or page items to Never.
Table 24-11 describes attributes for defining authorization scheme and authentication requirements for the current page.
Table 24-11 Page Attributes: Security
Attribute | Description |
---|---|
Select an authorization scheme to be applied to the page. Authorization schemes are defined at the application-level and can be applied to many elements within the application. An authorization scheme is evaluated either once for each application session (at session creation), or once for each page view. If the selected authorization scheme evaluates to true, then the page displays and is subject to other defined conditions. If it evaluates to false, then the page does display and an error message displays. See Also: "Providing Security Through Authorization" |
|
Specifies whether this page has been defined as public or requires authentication. If a page is identified as public, the page can be viewed before authentication. This attribute only applies to applications requiring authentication. The application's page sentry function can access this page attribute to identify pages that do not require prior authentication to view. The implementation of the authentication scheme's page sentry function determines if this attribute has any effect. See Also: "Establishing User Identity Through Authentication" |
|
Use this attribute to enable or prevent deep linking to an application page. Options include:
See Also: "Authentication" |
|
Page Access Protection |
Note: This attribute only displays if Session State Protection has been enabled for the application. See "Understanding Session State Protection." Select a Page Access Protection level for the current page:
|
Setting this attribute to On has no effect on the page. Setting this value to Off generates the following HTML in the FORM tag: autocomplete="off" |
|
Note: This feature requires a modern browser that support the HTTP header response variable Options include:
From a security perspective and as a best practice, Oracle recommends the browser cache should be disabled. This prevents the browser from storing sensitive data and ensures the browser always request pages if the URL changes. Otherwise, it may even be possible to go back in the browser history after a logout and see cached content of the former session. |
|
The Rejoin Sessions attribute controls if Application Express should support application URLs that do not contain session IDs. When rejoin sessions is enabled, Application Express attempts to use the session cookie to join an existing session, when a URL does not contain a session ID. A more restrictive instance-level setting overrides this page level value. Warning: Enabling rejoin sessions may expose your application to possible security breaches, as it can enable attackers to take over existing end user sessions. To learn more, see "About Rejoin Sessions." From Rejoin Sessions, select an option:
See Also: "Browser Security," "About Rejoin Sessions," and "Configuring Rejoin Sessions" in Oracle Application Express Administration Guide |
Use the Allow duplicate page submissions list to specify whether users may process a page multiple times in a row. Set this attribute to No to prevent duplicate page submissions from being processed multiple times.
Examples of duplicate page submissions include:
A user clicks the Submit button multiple times.
You create a branch of type Branch to Page, and the user clicks the browser reload button.
In On duplicate page submissions go to this URL, enter a URL. Use this field if you set Allow duplicate page submissions to No. If you select No and a user attempts to submit the same page twice, Oracle Application Express displays an error message and a link to the URL you specify.]
Table 24-12 describes attributes to enable caching for the current page.
Table 24-12 Page Attributes: Server Cache
Attribute | Description |
---|---|
Specify whether or not to enable page caching. Page caching can improve performance because the page displays from cache instead of displaying dynamically. Options include:
|
|
Displays if you select you select Enabled or Cached by User. Specify the amount of time for which a cached page remains valid. |
|
Specify a condition. If the condition returns true, the page is displayed from cache. If the condition returns false, the page is rendered dynamically and is not retrieved from cache. |
|
Displays conditionally based on the selected Cache Page Condition. Enter values in this attribute based on the specific condition type selected. |
|
Displays conditionally based on the selected Cache Page Condition. Enter values in this attribute based on the specific condition type selected. |
See Also:
"Managing Cached Regions and Pages" in Oracle Application Express Administration Guide and "Utilizing Region Caching in Component View"
Select a build option for this page. You can use build options to enable or disable functionality. Most application attributes have a build option attribute. Do not specify a build option for the current page unless you plan to exclude the page in certain configurations.
Build options have two possible values: INCLUDE
and EXCLUDE
. If you specify an attribute as being included, then the Application Express engine considers it part of the application definition at runtime. Conversely, if you specify an attribute as being excluded, then the Application Express engine treats it as if it did not exist.
See Also:
Table 24-13 describes attributes used to control or modify how an application logs errors.
In-line Error Notification Text, enter the error text that displays in the #NOTIFICATION_MESSAGE#
template substitution string in the event an error occurs on the page.
Table 24-13 Page Attributes: Error Handling
Attribute | Description |
---|---|
Enter the error text that displays in the |
|
Enter the name of a PL/SQL error function to modify the existing error message and display location or log the error if one occurs. This function can reference a package function or standalone function in the database. For example: log_apex_error When referencing a database PL/SQL package or standalone function, use the #OWNER#.log_apex_error You must implement error handling functions using the syntax described in the
function <name of function> (
p_error in apex_error.t_error )
return apex_error.t_error_result
See Also: Note: Error handling specified at the page-level overwrites any error handling function specified at the application-level. See "Editing Application Attributes." |
See Also:
Use this attribute to enter Help text for the current page. Help text is displayed using a help system that you must develop.
See Also:
You can include JavaScript into your application by adding it to the JavaScript attribute of the page. This is a good approach for functions that are very specific to a page and a convenient way to test a function before you include it in the .js
file.
In the following example, adding the code would make the test
function accessible from anywhere on the current page.
To add JavaScript code to the JavaScript attribute:
The Rejoin Sessions attribute controls support for joining existing sessions (similar to deep linking). Technically, this attribute determines whether URLs to this application contain session IDs.
Warning:
Enabling rejoin sessions may expose your application to possible security breaches, as it can enable attackers to take over existing end user sessions. To learn more, see "About Rejoin Sessions."
To use Rejoin Sessions, administrators must enable Rejoin Sessions at the instance-level. A more restrictive value of Rejoin Sessions at the instance-level overrides application and page settings.
To configure Rejoin Sessions in Component View:
See Also:
Tip:
Creating a dialog page is a multiple step process. To learn more, see "Creating Dialog Pages."
To configure Dialog attributes in Component View:
See Also: