17.5 Managing Component Settings

Use Component Settings to set application level values for built-in Application Express components and installed plug-ins.

Tip:

The Component Settings in your environment will vary based on the currently selected application.

• Configuring Component Settings
  Developers can configure Component Settings to set application level values for built-in Application Express components and installed plug-ins.
• Integrating with Google Calendar
  Developers can enable calendars within an application to integrate with Google calendar data by configuring the Component Settings, Calendar.
• Configuring Color Picker Display
  Developers can control the Color Picker display style by configuring the Component Setting, Color Picker.
• Configuring Interactive Report Action Menu Structure
  Developers can configure Component Settings, Interactive Report to use the new structure or keep the legacy structure from earlier releases.
• Dynamically Adding Sliders to Regions
  Developers can dynamically add a slider to the region if the displayed region name exceeds the width of the region.
• Configuring Switch Defaults
  Configure the default display style for the Switch item type. Display options include On/Off switch toggle, pill button, or select list.
• Configuring Rich Text Editor Responsiveness
  Developers can configure whether the Rich Text Editor automatically adjusts to the width of the container region by configuring Component Settings, Rich Text Editor.
• Viewing the Component Settings History Report
  You can view a report of modifications made to Oracle Application Express components and installed plug-ins on the Component Settings History page.

17.5.1 Configuring Component Settings

Developers can configure Component Settings to set application level values for built-in Application Express components and installed plug-ins.

To configure Component Settings:

1. On the Workspace home page, click App Builder.
2. Select an application.
3. On the Application home page, click Shared Components.

   The Shared Components page appears.

4. Under Other Components, click Component Settings.
5. Click the component name.
6. In the Component Settings configure the appropriate settings and click Apply Changes.

   Tip:

   To learn more about a specific setting, see item Help.

17.5.2 Integrating with Google Calendar

Developers can enable calendars within an application to integrate with Google calendar data by configuring the Component Settings, Calendar.

To configure the Component Settings, Calendar:

1. On the Workspace home page, click App Builder.
2. Select an application.
3. On the Application home page, click Shared Components.

   The Shared Components page appears.

4. Under Other Components, click Component Settings.
5. Click the component name, Calendar.
6. In the Component Settings dialog:

   1. Google Calendar API Key - Enter the Google Calendar API key to enable calendars within this application to integrate with Google calendar data.

   2. Click Apply Changes.

17.5.3 Configuring Color Picker Display

Developers can control the Color Picker display style by configuring the Component Setting, Color Picker.

To configure the Component Settings, Color Picker:

1. On the Workspace home page, click App Builder.
2. Select an application.
3. On the Application home page, click Shared Components.

   The Shared Components page appears.

4. Under Other Components, click Component Settings.
5. Click the component name, Color Picker.
6. In the Component Settings dialog:

   1. Display Style - Options include:

      • Modern - Renders the color preview as a small circle inside the text field.

      • No Preview - Do not render a preview of the chosen color.

   2. Click Apply Changes.

17.5.4 Configuring Interactive Report Action Menu Structure

Developers can configure Component Settings, Interactive Report to use the new structure or keep the legacy structure from earlier releases.

The structure of the interactive report Actions menu has changed to be consistent with interactive grids.

To configure the Component Settings, Interactive Report:

1. On the Workspace home page, click App Builder.
2. Select an application.
3. On the Application home page, click Shared Components.

   The Shared Components page appears.

4. Under Other Components, click Component Settings.
5. Click the component name, Interactive Report.
6. In the Component Settings dialog:

   1. Actions Menu Structure - Specify how the Actions menu displays in interactive reports. Options include:

      • Interactive Grid - Select Interactive Grid to have the interactive report Actions menu match interactive grid.

      • Legacy - Select Legacy to have the interactive report Actions menu use the legacy structure.

   2. Click Apply Changes.

17.5.5 Dynamically Adding Sliders to Regions

Developers can dynamically add a slider to the region if the displayed region name exceeds the width of the region.

To configure Component Settings, Region Display Selector:

1. Navigate to the Shared Components page:
   1. On the Workspace home page, click App Builder.
   2. Select an application.
   3. On the Application home page, click Shared Components.
      The Shared Components page appears.
2. Under Other Components, click Component Settings.
3. Click the component name, Region Display Selector.
4. In the Component Settings dialog:

   1. Include Slider - Select Yes to dynamically add a slider to the region if the displayed region name exceeds the width of the region.

   2. Click Apply Changes.

17.5.6 Configuring Switch Defaults

Configure the default display style for the Switch item type. Display options include On/Off switch toggle, pill button, or select list.

To configure the Component Settings, Switch:

1. Navigate to the Shared Components page:
   1. On the Workspace home page, click App Builder.
   2. Select an application.
   3. On the Application home page, click Shared Components.

      The Shared Components page appears.

2. Under Other Components, click Component Settings.
3. Under Component Settings, click Switch.
4. Configure the following Component Settings:
   1. Display Style - Options include:

      • Switch

      • Pill Button

      • Select List

   2. On Value - Enter the value stored in the page item if the end user picks the On option. The value can be up to 255 characters long.
   3. On Label - Enter the text displayed for the On option. If no text is entered, the system default label is used.
   4. Off Value - Enter the value stored in the page item if the user picks the Off option. The value can be up to 255 characters long. This value is used if the page item is populated with a value which does not match either the On Value or Off Value.
   5. Off Label - Enter the text displayed for the Off option. If no text is entered, the system default label is used.
5. Click Apply Changes.

17.5.7 Configuring Rich Text Editor Responsiveness

Developers can configure whether the Rich Text Editor automatically adjusts to the width of the container region by configuring Component Settings, Rich Text Editor.

For new apps, this setting is enabled by default. For older apps (pre-18.1), this is disabled by default.

This setting requires a responsive application theme (such as Universal Theme).

To configure Component Settings, Rich Text Editor:

1. Navigate to the Shared Components page:
   1. On the Workspace home page, click App Builder.
   2. Select an application.
   3. On the Application home page, click Shared Components.

      The Shared Components page appears.

2. Under Other Components, click Component Settings.
3. Under Component Settings, click Rich Text Editor.
4. For Responsive in the Component Settings dialog:
   • Yes - The Rich Text Editor is responsive and automatically adjusts its width to the container region.
   • No - The Rich Text Editor is not responsive. Choose this option for older apps that use a non-responsive legacy theme.
5. Click Apply Changes.

17.5.8 Viewing the Component Settings History Report

You can view a report of modifications made to Oracle Application Express components and installed plug-ins on the Component Settings History page.

To view the Component Settings History report:

1. Navigate to the Shared Components page:
   1. On the Workspace home page, click App Builder.
   2. Select an application.
   3. On the Application home page, click Shared Components.

      The Shared Components page appears.

2. Under Other Components, click Component Settings.
3. Click the History tab.

   The History page displays as an interactive report. To customize the report, use the Search bar at the top of the page.