Configure edit/display mode

Enabling edit/display mode controls whether editable fields toggle between display and edit modes via an app-level Edit/Display button, allowing selective field editing while other fields remain read-only.

Configuration applies to:

Business use cases

Edit and display mode support controlled data maintenance by separating data viewing from data modification. Key scenarios include:

  • Controlled inline editing: Allow users to edit only fields that are intended to be changed while leaving other data read-only, reducing accidental modifications.

  • Flexible workflow support: Support workflows where some columns should be reviewed before editing, or edits are only enabled at specific stages.

  • Simplified UI for large tables: Avoid overwhelming users with all editable fields active at once; toggle between read-only and editable views to focus attention.

Procedure

The following procedure uses the example of an employee name and salary list, where the Employee Name column is read-only and the Salary column is editable, allowing HR managers to update sensitive fields without affecting core employee information.

  1. In the Application tree, select the Setting of your adaptive list application.

  2. In the Settings/properties pane, in the Properties section, select Enable Edit/Display Mode.

    Result: In the Preview pane, an Edit button appears in the app header. Editable fields are initially in display mode. A Display button appears once the Edit button is selected.

  3. In the Shell bar, select Save.

  4. Verify which fields are editable by reviewing the respective settings of the fields from the Application tree in the Settings/properties pane:

    Example: Employee Name (field type Input) → Editable checkbox not selected → remains read-only.

    Example: Salary (field type Input) → Editable checkbox selected → will switch to editable when Edit is selected.

    Editable fields in the adaptive list template that respond to Enable Edit/Display Mode include:

    • ColorPicker

    • Checkbox

    • Switch

    • Input (with or without input mask)

    • DatePicker

    • DateTimePicker

    • SingleSelect Lookup

    • SingleSelect Script

    • MultiSelect Lookup

    • MultiSelect Script

  5. In the Preview pane, select the Edit button in the app header.

    Result: Editable fields, such as for Salary, become editable. Read-only fields, like for Employee Name remain in display mode. The Edit button togges to a Display button.

  6. Press the Display button.

    Result: Editable fields return to display mode. Read-only fields remain unaffected. The button toggles back to Edit.

In the Settings/properties pane, if Enable Edit/Display Mode is not selected all fields that are editable in the template remain editable at all times, and the Edit/Display toggle is not shown.

Result

  • You have enabled editable fields to toggle between display and edit modes, while fields that are read-only remain protected.

Related topics