Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Description

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

...

General Guidelines

Structure

  • A spreadsheet table

...

  • The table contains a grid of rows and columns.The table may contain, including:

    • a header row.,

    • a header column.,

    • a total row (optional).

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

Content

Numbers inside cells will be aligned to the right.

States

State

Example

Comments

Regular

Image Removed
Text Field.pngImage Added

Hover

Image Removed
Text Field-3.pngImage Added

Selected

Image Removed
Text Field-4.pngImage Added

Disabled

Image Removed
Text Field-5.pngImage Added

No Data

Image Removed
Text Field-6.pngImage Added

Error

Image Removed
Text Field-1.pngImage Added

See Field Validation.

Warning

Image Removed
Text Field-2.pngImage Added

Focus

Image Removed
Focused.pngImage Added

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).

    • exit edit mode, returning the cell to the selected state.

  • Hitting the Tab key 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 cell (to the right of the current one), while skipping disabled cells. If the focused cell is the last one on the row, hitting Tab will set the focus to the first cell of the next row.

  • 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.

...