Grid Selection General

General Selection Specification

Contents

1. References

2. Overview

3. Functionality

   3.1. End User Experience

   3.2. API

4. User Stories

5. ARIA support

6. Assumptions and Limitations

Revision History

Version	User	Date	Notes
0.1	Zdravko Kolev	July 15, 2019	Initial Draft
1.0	Zdravko Kolev	July 25, 2019	Use two inputs for cell and row selection

References

Row Selection

Multi-cell Selection

Overview

Different selection scenarios should be supported by the igxGrid.

Objectives

1. Each selection type (row/cell) should have the ability to be disabled.
2. Both selection types should be working simultaneously. ..

Functionality

Provide a way to configure different selection scenarios with the usage of two @Inputs - rowSelection and cellSelection.

3.1 End User Experience

rowSelection will accept Enumeration value type:

1. none - Row selection would be disabled for the Grid
2. single - Selection of only one row within the grid would be available.
3. multi - multi-row selection would be available by using a key combination like ctrl+click, or by pressing the space key once a cell is focused

cellSelection will accept Enumeration value type:

1. none - Cell selection would be disabled for the Grid
2. single - Selection of only one cell within the grid would be available.
3. multi - Currently, this is the default state of the selection in the grid. Multi-cell selection is available by mouse dragging over the cells, after a left button mouse click.

Use hideRowSelectors @Input in order to hide the Row selectors on row selection (old property name was rowSelectable), the default value is false, which means that when the user sets selectionMode to single-cell and single-row selection, multi-row selection or multi-row and multi-cell selection Row selectors will be visible (checkboxes). The end user should explicitly set hideRowSelectors to true in order to hide them.

3.1 API

Name	Type	Description
rowSelection	Enumeration	Set row selection type - none, single, multi
cellSelection	Enumeration	Set cell selection type - none, single, multi
hideRowSelectors	Boolean	Hide Row selectors, default value is false

Limitations and concerns

• Should we expose selected rows as a collection in the Copy Clipboard functionality.
• Integration of the new Selection with MRL and KB navigation.
• Consider removing of the focus on a cell - Note: KB navigation will benefit from this.

End User Experience

[To be updated with action images after the design meeting]

Developer experience

User Stories

ARIA support

Assumptions and Limitations

Test plan