Description

A Spreadsheet table is a type of Data Table where users can add and edit numeric data within the grid.

Usage & Behaviour

General Guidelines

Structure

An extended rows table is similar to a standard Data Table.

• The table contains a grid of rows and columns.

• The table may contain:

  • a header row.

  • a header column.

  • a total row.

• If the table is higher than its container, a Scrollbar will appear. The scrollbar will not affect the header or title rows, where they exist.

Content

• Numbers inside cells will be aligned to the right.

States

State	Example	Comments
Regular
Hover
Selected
Disabled
No Data
Error		See Field Validation.
Focused (edit mode)		Only one cell can be in focus at any time.

Interaction

• Clicking a cell will:

  • select the cell.

  • deselect all other cells.

  • change the cell to an input field, allowing the user to edit it.

  • If the cell is already in focus, clicking the cell will place the insertion point on cursor location.

• Hitting the Enter key when a cell is selected or focused will:

  • save the text in the cell (if it exists).

  • remove the input field, returning the cell to the selected state.

• Hitting the Tab key or the arrow keys when a cell is selected or focused will:

  • save the text in the cell (if it exists).

  • deselect the cell.

  • move the focus to the next relevant cell, while skipping disabled cells.

• Dragging the cursor over a group of cells selects that group of cells.

• A focused cell will have a special handle in the bottom-right corner. See States above.

  • Hovering over the handle will switch the cursor to a cross.

  • Dragging the handle will copy the content of the cell to the target cells.

• The user can cut, copy, and paste cell content using Ctrl / Cmd + X, C and V respectively.

Validations and Errors

Errors may include:

• typing long text in a cell.

• typing invalid data in a cell.

• deleting mandatory cells.

For more information please refer to the Field Validation page.

Best Practices

Use:

• when the spreadsheet table supports another set of data, such as a graph.

Accessibility compliance

Unless otherwise specified, see our general compliance information in Fundamentals - Accessibility.

Design

Code

<<a box containing the code - discuss with Femi>>