Documentation

    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.

    The live example needs a desktop screen. The result it produces is shown here, and the explanation and settings below work on any screen.

    Result
    DrinkStoreCups
    TeaOslo14
    TeaRome9
    TeaLima6
    LatteOslo21
    LatteRome28
    LatteLima12
    MochaOslo8
    MochaRome11
    1. Select Rome in the Store control. The chart now shows only Rome: Tea 9, Latte 28 and Mocha 11.
    2. Select All stores to bring back every store.
    3. 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

    1 port
    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: Dropdown

    Options: Dropdown, List, Buttons.

    Orientation

    Arranges the buttons horizontally or vertically.

    Default: Horizontal

    Options: 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: Popup

    Options: Popup, Always visible.

    Period placement

    Opens the period list in a popup, or keeps it visible in the control.

    Default: Popup

    Options: 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: Immediately

    Options: 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: Auto

    Options: 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: Automatic

    Options: Automatic, Custom.

    Bounds

    Takes the slider range from the data automatically, or from the Minimum and Maximum you set.

    Default: Automatic

    Options: 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.