Skip to content

Grid Add Row

Stefan Ivanov edited this page Aug 24, 2020 · 32 revisions

Add Row Specification

Contents

  1. Overview
  2. User Stories
  3. Functionality
  4. Test Scenarios
  5. Accessibility
  6. Assumptions and Limitations
  7. References

Owned by

Team Name

Developer Name

Stefan Ivanov

Requires approval from

  • Peer Developer Name | Date:
  • Stefan Ivanov | Date:

Signed off by

  • Radoslav Mirchev | Date:
  • Radoslav Karaivanov | Date:

Revision History

Version Users Date Notes
1 Stefan Ivanov 22.08.2020 Initial Draft

The Add Row functionality of the Grid provides the interface for inserting a new row of data that is input by the end-user field after field at the time of creation.

Objectives

Inserting additional rows of data should be an easy and intuitive experience that feels like belonging to the grid. Added rows should appear after the last row in the current context and there should be a clear indication that sets the correct expectation about this position. While the user puts in data, the record is not subjected to filtering, sorting and similar data operations, this happens once the row addition completes with a confirming action, when also a Snackbar notification is shown confirming the addition.

End-to-end user experience prototype

Acceptance criteria

Must-have before we can consider the feature a sprint candidate

...

Elaborate more on the multi-facetted use cases

Developer stories:

  • Story 1: As a developer, I want to allow the addition of data rows via a property, so that I can let users insert records like in excel
  • Story 2: As a developer, I want to…, so that I can… prototype
  • Story 3: As a developer, I want to…, so that I can… prototype

End-user stories:

  • Story 1: As an end-user, I want to add rows of data in a grid, so that I can create new data records prototype
  • Story 2: As an end-user, I want to trigger row addition from wherever I am in the grid so that I don't have to scroll to a particular place or look for a specific button to do so prototype
  • Story 3: As an end-user, I want to input values cell after cell for every column similarly to how I edit a row so that I can fill all columns prototype
  • Story 4: As an end-user, I want to add rows as siblings or children when data is organized hierarchically so that I have control over where records are inserted prototype
  • Story 5: As an end-user, I want to cancel the addition of the data, so that I can discard my input so far prototype
  • Story 6: As an end-user, I want to have a visual indication where a row will be added so that I have correct expectations prototype
  • Story 7: As an end-user, I want to have a visual confirmation that a row has been added once I complete its input so that I have certainty that my data was added prototype
  • Story 8: As an end-user, I want to make the grid scroll to the just added row so that I can inspect if it contains the correct information prototype

Describe behavior, design, look and feel of the implemented feature. Always include visual mock-up

3.1. End-User Experience

** Integration scenarios or functionality with other features/components prototype

** End-to-end user experienceprototype

** Prepared design files for styling e.g. interplay with features and light/dark variants design hand-off

3.2. Developer Experience

3.3. Globalization/Localization

Describe any special localization requirements such as the number of localizable strings, regional formats

3.4. Keyboard Navigation

Name Description

3.5. API

Options

Name Description Type Default value Valid values

Methods

Name Description Return type Parameters

Events

Name Description Cancelable Parameters

Automation

  • Scenario 1:
  • scenario 2:

ARIA Support

RTL Support

Assumptions Limitation Notes

Specify all referenced external sources

Clone this wiki locally