Inline edit

An inline edit component allows users to switch between read-only and edits views of description lists, page text elements, or tables—within the context of their current view.

Elements

Elements vary depending on inline edit variation

Usage

When to use

  • All editable elements can be viewed within the row or expanded row.
  • The data needs to be updated frequently.

When not to use

  • The editing is the primary function of the view. For example, in an edit modal.

Inline edit components.

Variations

  1. Page inline edit: enables the user to edit a specific field in a details page or in a full page.
  2. Table inline edit: enables the user to edit elements in a row.

Page inline edit

  • Field-specific edit: allows users to make changes to one field at a time
  • Full page edit: allows users to make multiple changes at a time, in a larger area with more fields

Page inline elements

Form inline edit elements
  1. Toggle: Indicates the edit action
  2. Tooltip: Provides a short description of the inline edit toggle
  3. Action group: Allows the user to save or cancel changes
  4. Form elements: Examples include text input or text area. See forms for more information about form elements.

Field-specific edit

When to use

Use field-specific edit when you want to allow users to make small edits to specific fields in a page.

How to use

The pencil toggle is placed inline with the header for fields that are editable. Clicking on this toggle allows the user to edit inline, or can trigger a modal for more complex edits. In edit mode:

  • The check icon saves the changes and switches the item back to read-only mode.
  • The close icon returns to the read-only mode without saving new data.
Specific field edit

Full page edit

When to use

Use the full-page edit when you want to allow users to edit a larger area with many editable elements all at once.

How to use

Any editing is triggered by an edit link for the whole section. All edits should be easily done in the context of the page. Clicking the pencil icon toggles the page or description list into edit mode.

  • Non Editable fields, for example, Name, and Labels should use read-only styling.
  • Editable fields should function like any form.
  • Users can save or cancel changes using the ‘Save’ or ‘Cancel’ button. Both actions return a page or description list to the read-only mode.
Full page edit

Table inline edit

  • Row edit: allows for making changes to 1 editable row in the table

Table inline elements

Table inline edit elements
  1. Editable inactive row: Inactive row with read-only styling
  2. Editable active row: Ability to edit form components is enabled
  3. Disabled input field: Unclickable and unusable input field
  4. Editable input field: Changes for this input are allowed
  5. Active input: Selected input field with new content
  6. Action group: Allows user to save or cancel changes
  7. Tooltip: Provides a short description of the inline edit toggle
  8. Toggle: Indicates the edit action

Row editing

Row editing allows a user to edit items that are visible in the table by having a pencil toggle pinned to the right side, with the kebab.

When to use

Use row editing when:

  • You need to change the data in a table.
  • The data is not dependent on each other. For example, changing the data in a row five will not affect row three.

How to use

Clicking the pencil icon toggles the particular table row into edit mode. In the edit mode:

  • The kebab is replaced with a check icon for saving and a close icon for canceling. Both icons should be grey until changes have begun to be made.
  • Once changes begin, the check icon turns blue to increase the visibility of the save action.
  • The check icon button submits the changes and switches the row back to the read-only mode.
  • The close icon returns to read-only mode without saving new data.
Row editing

Some are elements may be difficult to edit in a table. You can make them editable in a modal instead.