Related Pages: Data Tables
Description
An editable table is a Data Table in which the user can edit data inside a row, without the need to navigate to a separate page, a panel, or a popup.
Basic Flow
An editable table is similar to a basic table, with these exceptions:
Clicking the edit icon in any row:
Selects that row (if not already selected).
Changes all relevant cells of that row to input fields. This may include text fields, drop-down menus, spinners, date pickers etc.
Replaces all action icons with two icons: confirm (✓) and cancel (X).
The user can enter or update any input field, in any order.
When finished, the user can click on one of the two icons:
Clicking the confirm (✓) icon changes all input fields back to text, with the updated values.
Clicking the cancel (X) icon changes all input fields back to text, with the previous values.
Validations and Errors
Long inputs in table text fields will be managed as in regular Text Fields, unless otherwise specified. (It is always a good practice to match the length of the field to the expected text).
In edit mode, if the user clicks on any other element on the page after changing any field, a popup window will appear, warning about the potential data loss. In this case:
If the user chooses to continue editing, the popup will close, and the page will auto-scroll to the relevant row, if needed.
If the user chooses to close and discard changes, the row will switch back to normal mode, with the previous set of values.
Best Practices
Use:
when the table is relatively simple.
Don’t use:
where selecting a row is the first step of a complex flow.
where the table contains more than 8 columns.
where one or more of the fields can hold large amounts of text.
Accessibility compliance
Focus management
In edit mode:
By default, the first input field will be in focus.
The user can move the focus to the next or previous field using Tab or Shift+Tab.
Clicking Enter when the focus is on a text field will change all input fields back to text, with the updated values.
Unless otherwise specified, see our general compliance information in Fundamentals - Accessibility.
Design
Zeplin link | Screen thumbnail |
|---|---|
<<Short Zeplin link. You | <<Screen with 200 width>> |
Code
<<a box containing the code - discuss with Femi>>