Carbon Design System Filtering Pattern
Documents filtering as adding or removing predefined attributes from data sets, including multi-category filters, batch versus instant updates, visible applied-filter indicators, and reset behavior.
What this source can teach
Use this source to compare a documented solution with the task and states in your own product.
- Start with the original. Open the source and find the guidance or example relevant to your task.
- Trace the connection. Use the claim notes below to see how this site applies the source to specific patterns.
- Check the setting. Compare the source's platform, people, and constraints with your own decision.
Pattern Decisions This Source Supports
| Pattern | Supported decision | Required contract | Claim note |
|---|---|---|---|
| Faceted search | Choose faceted search when users need to progressively narrow a large set by multiple attributes. | Applying or removing a facet updates the result count and preserves visible applied filters. | Carbon filtering guidance supports multi-category filters, batch or instant updates, visible applied-filter indicators, and reset behavior. |
| Filter panel | Choose a filter panel when users need grouped controls for narrowing the current result set by several criteria. | Each filter category has a clear label and contains controls appropriate to the value type, such as checkboxes, radios, ranges, date fields, or text fields. | Carbon filtering guidance documents multiple categories, batch versus instant updates, hidden filter indicators, and reset behavior. |
| Filter reset that clears unrelated search | Flag this anti-pattern when a filter reset clears or changes query text, submitted search, search scope, saved search identity, search history, sort order, page size, view mode, selected rows, or route context that is not visibly part of the filters. | Every reset control names the state it changes. | Documents filtering reset behavior, batch and instant update models, hidden active indicators, and reset scope. |
Comparisons supported by this source
- Drawer vs modal dialog vs navigation drawer vs filter panel
Carbon filtering guidance supports the distinction between generic side drawers and filter-specific panels with active-state and result synchronization duties.
- Faceted search vs no-results recovery
Carbon filtering guidance distinguishes multi-category filtering, instant versus batch updates, and filter reset behavior.
- Filter panel vs faceted search vs no-results recovery
Carbon distinguishes single selection, multiselect, multiple categories, batch updates, instant updates, hidden-container indicators, and reset behavior.
- Filter reset that clears unrelated search vs filter panel vs basic search vs filter chips vs saved search
Supports distinguishing filter reset behavior, batch versus instant filtering, hidden active indicators, and reset scope.
Evidence Role
This source is treated as pattern-library evidence. Its value comes from the specific claims and setting described above.
Publisher: IBM Carbon Design System. Last checked: .