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.

See Also:

"Understanding Page-Level Items"

To edit item attributes:

Navigate to the Page Definition. See "Accessing the Page Definition".
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.
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