Search This Blog

Friday, July 18, 2025

AVAILABLE ITEM TYPES

 In Oracle APEX App Builder, page items are UI components that display data or capture user input. Each item type offers distinct features and is governed by attributes that control behavior, display, and validation. Below is a comprehensive breakdown of common item types and their configurable properties in Page Designer.

Check Box

Used to display multiple values as checkboxes, allowing users to select more than one value. The selected values are stored in a colon-delimited string.

  • Use Case: For multi-select inputs.

  • Note: For a Yes/No option, prefer the Switch item.

  • Example:

    SELECT ename, empno FROM emp;
    
  • Key Attributes:

    • Validation > Value Required: Ensures the item is not null upon submit.

    • Settings > Number Columns: Defines how many checkbox columns to display.

  • More Info: Refer to APEX_UTIL for handling multiple returned values.

Color Picker

Allows users to select or input a color code using a palette.

  • Note: Choose "Popup LOV" then set to "Color Picker".

  • Key Attributes:

    • Validation > Value Required

  • See Also: “Configuring Color Picker Display”

Date Picker

Displays a calendar popup to pick dates and optionally time.

  • Time: Shown if the format mask includes time components.

  • Key Attributes:

    • Highlighted Date, Min/Max Date

    • Show Other Months

    • Format Mask

Display Image

Renders an image from a BLOB column or image URL.

  • Key Attributes:

    • Based On: Defines image source.

    • BLOB Last Updated Column: Enables caching.

Display Only

Displays static, non-editable values.

  • Key Options:

    • Save Session State

    • Based On: Can display values from a list, PL/SQL code, or item value.

File Browse

Enables file uploads.

  • Storage Options:

    • BLOB Column

    • APEX_APPLICATION_TEMP_FILES

  • Key Attributes:

    • Purge File At

    • Allow Multiple Files

    • MIME Type, Filename, Character Set Columns

    • Download Link Text

Hidden

Stores data without rendering it to the user.

  • Key Attribute:

    • Value is Protected: Prevents client-side tampering.

List Manager

Allows users to manage a set of values using Add/Remove controls.

  • Storage: Selected values stored in colon-delimited format.

  • Key Attribute:

    • Fetch: Defines LOV behavior.

Number Field

Used to input numbers.

  • Validation: Auto-checks numeric values.

  • Key Attributes:

    • Minimum / Maximum Values

    • Number Alignment

Password

Accepts secure input (obscured characters).

  • Security Best Practice: Avoid storing passwords in session state.

  • Key Attributes:

    • Submit on Enter

    • Store Encrypted in Session State

Percent Graph

Displays numeric value (0–100) as a visual percentage bar.

Popup LOV

Displays a searchable list in a popup dialog.

  • Best for: Large data sets.

  • Example:

    SELECT ename || ' ' || job display_value, empno FROM emp;
    
  • Key Attributes:

    • Input Field

    • Fetch Method

Radio Group

Displays a single-select set of options as radio buttons.

  • Example:

    SELECT ename, empno FROM emp;
    
  • Key Attributes:

    • Number of Columns

    • Page Action on Selection

    • Execute Validations

Rich Text Editor

Provides a WYSIWYG editor for formatted content entry.

  • Key Attributes:

    • Editor, Toolbar Options

    • Toolbar Position

Select List

Displays a drop-down list of predefined values.

  • Best for: Small to medium lists.

  • Example:

    SELECT displayValue, returnValue FROM ...
    
  • Key Attributes:

    • Page Action on Selection

    • Execute Validations

Shuttle

Allows users to move multiple values between two lists.

  • Storage: Colon-delimited string.

  • Key Attributes:

    • Show Controls: Define available move/order buttons.

Switch

Toggle control used for binary choices (Yes/No).

  • Key Attributes:

    • Settings: Use default or custom.

    • Validation > Value Required

Slider

Used in jQuery Mobile apps.

  • Key Attributes:

    • Min/Max Values

    • Step Increment

    • Highlight Selected

Text Field

Basic single-line input field.

  • Key Attributes:

    • Subtype: HTML5 input types (e.g., email, tel).

    • Validation > Value Required

Text Field with Autocomplete

Shows suggestions as the user types.

  • Best for: Quick filtering of large datasets.

  • Key Attributes:

    • Search Type

    • Lazy Loading

    • Max Values

    • Highlight Matching Terms

Text Area

Multi-line input area.

  • Key Attributes:

    • Resizable

    • Auto-Height

    • Character Counter

Plug-ins

Additional item types may be available through plug-ins, appearing as <My Plug-in> [Plug-in].

Best Practices

  • Always use Value Required validation where appropriate to enforce data integrity.

  • For dynamic or long lists, prefer Popup LOV or Autocomplete for better performance.

  • For secure inputs like passwords, avoid saving values in session state and use encryption.

  • Use BLOB Last Updated to improve image/file cache handling.

  • Avoid exposing hidden item values to client-side manipulation—enable Value is Protected.

For More Details
Visit the official Oracle APEX documentation:
Oracle APEX Item Types – Documentation

Let me know if you’d like this adapted into a downloadable format or published-ready markdown.

No comments:

Post a Comment

Using a Badge in Oracle APEX

 In Oracle APEX, badges are small visual indicators typically used to highlight numeric values, such as counts, statuses, or notification in...