Dropdown

Filter Scope

dropdown - filter using a single selection of multiple items.

status:
    type: dropdown
    options:
        pending: Pending
        active: Active
        closed: Closed

The following properties are available for the filter.

Property	Description
options	available options for the filter, as an array or method name.
conditions	a custom SQL select statement to use for the filter.
emptyOption	text to display when there is no available selections.

You may pass custom SQL to the conditions as a string where :value contains the filtered value.

status:
    type: dropdown
    conditions: status = :value
    # ...

You may dynamically supply options by passing a model method.

roles:
    type: dropdown
    emptyOption: All
    options: getStatusOptions

The dropdown filter does not display a label, the emptyOption property can be used to set the default state.

status:
    type: dropdown
    emptyOption: Select Status
    # ...