Managing Radio Button Page Elements

Understanding Defining Radio Page Elements

To define a radio button page element you specify a boolean primitive element defined in the PeopleSoft document associated with the layout definition.

Adding Radio Button Page Elements to Pages

To add a radio button page element to a page:

1. Access the Layout grid on the Layout Designer – Layout page.

   Select PeopleTools > Mobile Application Platform > Layout Designer to access the page.

2. Determine the position in the grid to add the page element.

3. Click the row directly above where you want to add the page element to make it the current row.

   The Current Row icon (blue arrow) displays in the first column of the row to indicate that it’s the current row.

   Field or Control	Definition
   	The Current Row button

4. Click the Add Radio Button button.

   Field or Control	Definition
   	The Add Radio Button button.

After you select a position for the element in the Layout grid and click the Add Radio Button button , the “Do you want to create a group?” page appears:

Adding Groups of Radio Buttons to Pages

After you click the Add Radio Button control on the Layout grid toolbar on the Layout Designer – Layout page, the “Do you want to create a group?” page appears, giving you the option to create a group of radio buttons.

Image: “Do you want to create a group?” page

This example illustrates the fields and controls on the “Do you want to create a group?” page. You can find definitions for the fields and controls later on this page.

If you want to create a group of radio buttons, enter the number of group items to create in the Number of Group Items field and click the Yes button. If you do not want to create a group of radio button elements click the No button.

For more information about creating element groups, see Managing Element Groups

After you click Yes to create a group or radio buttons or click No to not create a group of radio buttons, the Select Boolean Primitive for Radio Button page appears. See the next section for information about how to use the page.

Using the Select Boolean Primitive for Radio Button Page

Use the Select Boolean Primitive for Radio Button page to select a value for the element.

Image: Select Boolean Primitive for Radio Button page

This example illustrates the fields and controls on the Select Boolean Primitive for Radio Button page. You can find definitions for the fields and controls later on this page.

The boolean primitive elements defined in the PeopleSoft document defined for the layout appear on the page. The page displays only those boolean primitive elements that are not already defined for other elements in the layout.

After you select the value for the element the Layout Designer–Layout page appears.

Viewing Defined Radio Button Page Elements in the Layout Grid

After you define a radio button using the Select Boolean Primitive for Radio Button page, the Layout Designer – Layout page appears and the element appears in the Layout grid.

The default element ID for a radio button page element is the name of the primitive you defined for it., for example <primitive_name>_n.

By default the system populates the Label Text field with the name defined in the Element Name field in the PeopleSoft document.

Image: Radio button element defined in the Layout grid

This example illustrates a radio button element defined in the Layout grid.

In the example, APPROVAL_STATUS_1 is the element ID and APPROVAL_STATUS is defined as the label text. These values are defaults from the primitive element defined for the radio button.

Defining Display Labels for Radio Button Page Elements

The value in the Label Text field for a radio button element is the label that appears for the button at runtime. And as described previously, the default value is the value defined in the Element Name field for the primitive in the PeopleSoft document.

You can keep the default value, define a different value, or remove it.

In the same row as the radio button element are class, style, and theme fields. Use these fields to define a custom CSS3 class name and custom CSS3 style name for the display label. (Note that any class or style you enter must be defined in the Layout Designer – CSS page.) Use the theme field to define a jQuery theme for the display label.

Understanding Defining Radio Button Page Element Properties

To define properties for radio button page elements, use the Radio Button Properties page.

Many properties that appear on the Radio Button Properties page also appear on the properties pages for other page elements. For more information and links to topics about these common properties, see the topic Common Layout Page Element Properties

This topic discusses using the properties on the Radio Button Properties page that are unique to working with radio button page elements. These properties are located in the Radio Button Properties section of the page.

Defining Radio Button Properties

To access the Radio Button Properties page, in the Layout grid on the Layout Designer – Layout page click the Properties link next to the radio button element for which you want to define properties.

Image: Radio Button Properties section

This example illustrates the fields and controls in the Radio Button Properties section of the Radio Button Properties page. You can find definitions for the fields and controls later on this page.