Filter
Filter lets readers narrow the data behind visuals. It's backed by a Vista Filters block in Strata, placed before the Vista Source.
Filter a chart by store
A Store control narrows a chart of cups by drink to Oslo, Rome or Lima. Behind it, a Vista Filters block sits between the sales data and the Vista Source. The dashboard is read-only, but the control still works.
Filter interactive example
Loading interactive example…
The live example needs a desktop screen. The result it produces is shown here, and the explanation and settings below work on any screen.
| Drink | Store | Cups |
|---|---|---|
| Tea | Oslo | 14 |
| Tea | Rome | 9 |
| Tea | Lima | 6 |
| Latte | Oslo | 21 |
| Latte | Rome | 28 |
| Latte | Lima | 12 |
| Mocha | Oslo | 8 |
| Mocha | Rome | 11 |
- Select Rome in the Store control. The chart now shows only Rome: Tea 9, Latte 28 and Mocha 11.
- Select All stores to bring back every store.
- Look at the flow below the dashboard: Manual Input goes into Vista Filters, then Vista Source.
When to use
Use Filter to let readers pick a slice of the rows, such as one store or a date range. To feed a chosen value into a calculation without removing any rows, use Parameter.
Inputs
- FilterOptional
Accepts: References.
Accepts one connection on this port.
Settings
To set one up, add Filter from the Controls tab, then choose a Source and a field in Properties. Applies to sets the reach: This page, Selected visuals or All pages using this source. Available choices sets which values are offered. Show in Strata jumps to the block behind it. See Parameters and filters.
All 40 settings
- Style
Shows the values as a dropdown, a list or buttons.
Default:
DropdownOptions: Dropdown, List, Buttons.
- Orientation
Arranges the buttons horizontally or vertically.
Default:
HorizontalOptions: Horizontal, Vertical.
- Show input fields
Shows or hides editable values beside the slider.
Default:
false- Show calendar input fields
Shows date entry fields alongside the calendar.
Default:
true- Calendar placement
Opens the calendar in a popup, or keeps it visible in the control.
Default:
PopupOptions: Popup, Always visible.
- Period placement
Opens the period list in a popup, or keeps it visible in the control.
Default:
PopupOptions: Popup, Always visible.
- Include All option
Adds a choice that removes the filter, next to the other options.
Default:
true- Show “All” button
Shows or hides a separate All button that removes the filter.
Default:
false- Show all/relevant choices toggle
Adds a button that switches between relevant choices and all choices.
Default:
true- Apply changes
Applies a multiple selection as soon as it changes, or only when a reader selects Apply.
Default:
ImmediatelyOptions: Immediately, With Apply button.
- Size (px) (Values)
Size of the value text, in pixels.
Default:
14- Text color (Values)
Color of the value text.
- Search
Shows or hides the search box, or lets the control decide automatically.
Default:
AutoOptions: Auto, Show, Hide.
- Decimal places
How many digits appear after the decimal point.
Default:
2- Prefix
Text shown before each number.
- Suffix
Text shown after each number.
- Gap (px)
Space between buttons, in pixels.
Default:
6- Horizontal padding (px)
Space inside each option on the left and right, in pixels.
Default:
10- Vertical padding (px)
Space inside each option above and below, in pixels.
Default:
6- Rounding (px)
How rounded the option corners are, in pixels.
Default:
6- Background
Fill color of each option.
- Border
Border color of each option.
- Selected text
Text color of a selected option.
- Selected background
Fill color of a selected option.
- Selected border
Border color of a selected option.
- Step
Picks the slider increment from the data automatically, or uses the Step size you set.
Default:
AutomaticOptions: Automatic, Custom.
- Bounds
Takes the slider range from the data automatically, or from the Minimum and Maximum you set.
Default:
AutomaticOptions: Automatic, Custom.
- Track thickness (px)
Thickness of the slider track, in pixels.
Default:
4- Handle size (px)
Size of the slider handle, in pixels.
Default:
16- Track color
Color of the slider track.
- Active track color
Color of the selected part of the slider track.
- Allow custom periods
Lets readers enter their own date range as well as choosing a listed period.
Default:
true- Periods
Relative periods readers can choose from, such as Last 7 days.
Options: Last 7 days, Last 30 days, Month to date, Last month, Year to date, Custom range.
- Text for “All” (optional)
Leave empty for an automatic label.
- Text
Label text shown on the filter.
- Show label
Shows or hides the filter's label.
Default:
true- Size (px) (Label)
Size of the label text, in pixels.
Default:
14- Text color
Color of the label text.
- Corner radius (px)
Corner radius in whole logical pixels.
Default:
0- Border width (px)
Border width in whole logical pixels.
Default:
0
Filter FAQs
- Does a filter restrict what viewers can access?
- No. Viewers can access the input data used by a dashboard. Filters and initial selections do not restrict which rows they can access.
- Do filter selections affect other viewers?
- No. On a published dashboard, viewer selections affect only their own session.
- Can one filter affect several pages?
- Yes. In Applies to, choose All pages using this source.
Chart your data. Build it in Vista.
Vista opens in your browser, with no account.