1. App Builder User's Guide
  2. Using Themes and Theme Styles
  3. Creating Custom Themes
  4. Using Template Options
  5. Managing Global Template Options

11.3.6.1 Managing Global Template Options

Gobal template options are defined at the theme-level.

Tip:

In order to add or edit template options, you must be the theme owner. See Unsubscribing to a Theme.

See Also:

About Template Options

Parent topic: Using Template Options

11.3.6.1.1 Creating Global Template Options

Define global template options on the Themes page under Template Options.

To create a global template option:

  1. Navigate to the Themes page:
    1. On the Workspace home page, click the App Builder icon.
    2. Select an application.
    3. Click Shared Components.
    4. Under User Interface, select Themes.
    The Themes page appears.
  2. Select a theme.
  3. Locate Template Options and click Add Template Option.
    A new row appears.
  4. Edit the attributes:
    1. Template Type - Select the type of template for which the template option is defined.
    2. Group - Select a group name. Group names enable you to group template options and avoid the selection of conflicting option. See Managing Global Template Option Groups.
    3. Name - Enter a name for the template option.
    4. Identifier - Enter an alphanumeric, upper case identifier for the template option. Identifiers map a template option to a corresponding template option when switching themes.
    5. Sequence - Specify the sequence for this option.
    6. Classes - Enter one or more CSS classes that define this template option.
    7. Help Text - Enter a description of the template option.
  5. Click Save.

Parent topic: Managing Global Template Options

11.3.6.1.2 Editing Global Template Options

Edit existing global template options on the Themes page under Template Options.

To edit a global template option:

  1. Navigate to the Themes page:
    1. On the Workspace home page, click the App Builder icon.
    2. Select an application.
    3. Click Shared Components.
    4. Under User Interface, select Themes.
    The Themes page appears.
  2. Select a theme.
  3. Locate Template Options.
  4. To edit a template option:
    1. Select the row containing the template option.
      The row becomes hightlighted.
    2. Edit the appropriate attributes.
      • Template Type - Select the type of template for which the template option is defined.
      • Group - Select a group name. Group names enable you to group template options and avoid the selection of conflicting option. See Managing Global Template Option Groups.
      • Name - The name for the template option.
      • Identifier - An alphanumeric, upper case identifier for the template option. Identifiers map a template option to a corresponding template option when switching themes.
      • Sequence - Specify the sequence for this option.
      • Classes - Enter one or more CSS classes that define this template option.
      • Help Text - Enter a description of the template option.

      WARNING:

      If you edit the name of a CSS class, all components that reference that CSS class name must be updated manually. The Option Identifier cannot be modified since it is needed for mapping purposes.

    3. Click Save.
  5. To delete a template option:
    • Click the Row Actions menu and select Delete Row.

    Tip:

    To learn more about the Row Actions menu, see About the Row Actions Menu in an Interactive Grid in Oracle APEX End User’s Guide

Parent topic: Managing Global Template Options

11.3.6.1.3 Managing Global Template Option Groups

Define the purpose of related template options by creating template option groups. Examples of template option groups include Button Size, Button Style, List Examples, List Style, and Form Label Position.

Tip:

In order to add or edit template option groups, you must be the theme owner. See Unsubscribing to a Theme.

See Also:

About Template Option Groups and Presets and Understanding Template Options

Parent topic: Managing Global Template Options

11.3.6.1.3.1 Creating a Global Template Option Group

Global template option groups are defined at the theme-level and are available for all components of a given type.

When developers create a template option group, they can specify a template option preset at the template-level. For example, suppose you have a button template that has the template options Large and Small. If you define Small as the preset, then any new button referencing the template would automatically have the template option Small applied to it when is it created. Template options that are part of a group are optional unless defined at the template-level.

To create a global template option group:

  1. Navigate to the Themes page:
    1. On the Workspace home page, click the App Builder icon.
    2. Select an application.
    3. Click Shared Components.
    4. Under User Interface, select Themes.
    The Themes page appears.
  2. Select a theme.
  3. Locate Template Options and click Template Options Groups..
    The Template Options Groups window appears.
  4. To create a new group:
    1. Click Add Template Option Group.
      A new row appears.
    2. Edit the appropriate attributes:
      • Template Type - Specify the type of template for this template option group.
      • Name - Enter a display name for the template option group.
      • Identifier - Defines the internal name of the template option group.
      • Sequence - Specify the sequence for this template option group.
      • Null Text - Default value for the template option group if a user does not select any template option in that group.
      • Help Text - Enter a description of the template option group.
      • Advanced - Determines if the template option group belongs in the Basic or Advanced category of template options. Select Yes or No.
    3. Click Save.

Parent topic: Managing Global Template Option Groups

11.3.6.1.3.2 Editing Global Template Option Groups

Edit global template option groups by navigating to the Themes page.

To edit global template option groups:

  1. Navigate to the Themes page:
    1. On the Workspace home page, click the App Builder icon.
    2. Select an application.
    3. Click Shared Components.
    4. Under User Interface, select Themes.
    The Themes page appears.
  2. Select a theme.
  3. Locate Template Options.
  4. Click Add Template Option Groups.
    Template Options Groups dialog appears.
  5. To edit a template option group:
    1. Select the row containing the template option group.
      The row becomes hightlighted.
    2. Edit the appropriate attributes.
      • Template Type - Specifies the type of template for this template option group.
      • Name - Dsplay name for the template option group.
      • Identifier - Defines the internal name of the template option group.
      • Sequence - Specify the sequence for this template option group.
      • Null Text - Default value for the template option group if a user does not select any template option in that group.
      • Help Text - Enter a description of the template option group.
      • Advanced - Determines if the template option group belongs in the Basic or Advanced category of template options. Select Yes or No.
    3. Click Save.
  6. To delete a template option group:
    • Click the Row Actions menu and select Delete Row.

    Tip:

    To learn more about the Row Actions menu, see About the Row Actions Menu in an Interactive Grid in Oracle APEX End User’s Guide

Parent topic: Managing Global Template Option Groups