Skip Headers
Oracle® Application Express Application Builder User's Guide
Release 4.2

E35125-05
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to current chapter
Up
Go to next page
Next
PDF · Mobi · ePub

12.4 How Item Attributes Affect Page Layout

An item is part of an HTML form and can be a text field, text area, password, select list, check box, and so on. You can alter the appearance of a page by changing the item attributes. For example, these attributes can effect where a label displays, how large an item is, and if the item displays next to or below the previous item.

To edit item attributes:

  1. Navigate to the Page Definition. See "Accessing the Page Definition".

  2. Access the attributes page for the item:

    • Tree view - Right-click the item and select Edit.

    • Component view -Under Items, select the item name.

    Tip:

    You can also edit an item by double-clicking the item name or selecting the name and pressing ENTER. See "Editing a Page in Tree View".

    The Edit Page Item page appears.

  3. Under Items, click the item name.

    The Edit Page Item page appears.

Table 12-3 describes how item attributes affect the layout of a page.

Table 12-3 Item Attributes Effecting Page Layout

Heading Attribute Description

User Interface

Sequence

Specifies the display sequence for this component. The sequence determines the order of evaluation.

User Interface

Region

Defines the region where the item displays. All items must be in a region.

User Interface

Template

Indicates the item template. Item templates enable you to define the user interface attributes in a central place and share that definition among many page items.

Grid Layout

Start New Grid

Determines whether this page item displays in a new grid or in the same grid as the previous page item.

Grid Layout

Start New Row

Determines whether this page item displays on the same row as the previous page item or button, or whether it displays on the next row.

Grid Layout

Column

Determines if the page item should be displayed in a specific grid column. Use Automatic to automatically determine the next available grid column where the page item gets displayed.

Grid Layout

ColSpan

Determines how many grid columns should be occupied by the page item. Use Automatic to balance the available grid columns within all page items and buttons in the same grid row.

Grid Layout

RowSpan

If items are laid out in HTML tables, this attribute determines the value used for the ROWSPAN attribute in the table cell in which the page item displays.

Grid Layout

Column Attributes

Enter additional attributes which are set for the grid column. This value replaces the #ATTRIBUTES# substitution placeholder in the grid layout column template.

Label

Label

Identifies the field label for the page item. The label displays on the page only if the item displays. Depending on the label alignment, the label displays in its own HTML table cell for some displays or in the same cell for others. Item labels can include shortcuts using "SHORTCUT_NAME" syntax.

Label

Horizontal/Vertical Alignment

Controls the placement and the horizontal and vertical alignment of the label. Labels can be displayed above, below, or to the left of the item. When the label is displayed next to a form element, it occupies its own HTML table cell. By changing the alignment here, you control the label's position within that table cell.

Label

HTML Table Cell Attributes

Enter any additional attributes to be used in the HTML table cell that contains this label.

Element

Pre Element Texts

Specifies additional attributes for the HTML table cell used to display each individual option in a radio group or set of check boxes. Can include HTML, JavaScript, and shortcuts. You can reference the following substitution strings:

  • #CURRENT_FORM_ELEMENT# obtains the name of the HTML form element with which this post element text is associated.

  • #CURRENT_ITEM_NAME# obtains the name of the item with which this post element text is associated.

Element

Post Element Texts

Specifies additional attributes for the HTML table cell used to display each individual option in a radio group or set of check boxes. Can include HTML, JavaScript, and shortcuts. You can reference the following substitution strings:

  • #CURRENT_FORM_ELEMENT# obtains the name of the HTML form element with which this post element text is associated.

  • #CURRENT_ITEM_NAME# obtains the name of the item with which this post element text is associated.

Conditions

Condition Type and Expressions

Defines conditions and appropriate expressions that determine if an item displays.

See Also: "Understanding Conditional Rendering and Processing"

Read Only Display Settings

Read Only Condition Type

Defines conditions and expressions that determine if the item displays as read-only. Use this attribute to display certain items to a set of users as updatable, while displaying that same set of items to others users as nonupdatable. Using this attribute reduces the need to code duplicate interfaces for different users.

Depending on the item type, a read-only item renders as plain text or as not enterable field. Not selecting a condition causes the item to render normally.

Note: Set the condition type to Never to always render the item as enterable field. This overwrites any read-only condition defined at the region or page-level