Skip to content

Filtering per column

Stefan Stoyanov edited this page May 29, 2018 · 20 revisions

Filtering per column Specification

Contents

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

Objectives

Provide filtering per column and correspoding user interface.

Elaborate more on the multi-facetted use cases

As a citizen developer, I want:

  • Story 1: to be able to provide filtering per colunm, so that the users can operate with the data in the grid.
  • Story 2: …, so that I can…
  • Story 3: …, so that I can…

As an end user, I want:

As an user, I want to

  • have a filtering UI, so that I can filter the data in the grid.
  • access that UI from the header icon corresponding to the column I want to filter.
  • have immediate filtering, so that I won't need to click once more to filter.
  • have default conditions applied, so that I can filter faster.
  • have conditions to choose from, so that I can make a more precise filtering depending on my needs.
  • have the input on focus, if there is an input to а chosen condition, so that I can make an input right away.
  • be able to quickly clear the input, using a clear icon in the input.
  • have a one condition UI, so that I can filter depending on my needs.
  • have a non selected exclusive AND / OR toggle options after the first condition that toggle a second condition.
  • have the second condition removed/cleared if I deselect a selected toggle button.
  • having Reset Button so that I can reset all conditions at once.
  • have a Reset button inactive when there is no filter applied, since there is nothing to reset.
  • to have an option to have a Close button so that I can close it without clicking outside the toggle.

Acceptance criteria

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

...

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

3.1. End User Experience

3.2. Developer Experience

In order to turn on the filtering, 'filterable' Input should be set to true to the column, which we want to make filterable.

3.3. Globalization/Localization

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

3.4. User Interface

1 2 3 4 5 6

3.5. Navigation

3.6. API

Options

Name Description Type Default value Valid values

Methods

Name Description Return type Parameters

Events

Name Description Cancelable Parameters

Automation

  • One or more conditions can be applied to a single column:
    • number column;
    • string column;
    • date column;
  • Two conditions can be applied to two columns at once
  • Clicking And or Or button shows second select and input for adding second condition
  • Adding two conditions to a single column trough API correctly updates the filter dialog
  • After filling the first condition the grid is filtered, then after adding the second condition the grid is updated
  • Clicking Reset button clears all conditions
  • After edit/remove first or second condition the grid is updated
  • Unselecting And/Or:
    • hides second condition UI
    • removes the second filter expression
    • preserve the values in the second condition UI

Specify only if applicable

Assumptions Limitation Notes

Specify all referenced external sources

Clone this wiki locally