Skip to content

The Filter Form Cell

The filter form cell allows the user to select multiple values from a group of values. The values are either displayed using Material Design Chips or a collection of check boxes.


By default, chips are displayed on a single line that scrolls horizontally:

Filter chips

Filter chips scrolling horizontally

The chips can also wrap on to multiple lines:

Multi-line filter chips

The boolean attribute singleLine determines how the chips are placed.

Values can also be displayed using check boxes. Check boxes may be a better choice when:

  • The labels for values are long.
  • The selections have a certain semantic order.
  • There are more than 10 values to select from.

Filter checkboxes

The boolean attribute useChips determines if chips or check boxes are displayed.


By default, chips are displayed with a filled background:

Filled chip

Chips can also be displayed with an outlined border:

Outlined chip

The boolean attribute outlined determines if chips are outlined.

Using Filter Form Cell

The filter form cell can be placed within your activity like any traditional Android view:

    app:key="Multi line"
    app:value="@array/filter_for_cell_values_1" />

Callback Mechanism

The filter form cell supports callback listeners, such as OnCellChangeListener<List<Integer>>, to notify the application of changes to the selected choice.

The OnCellChangeListener<List<Integer>> callback is called whenever a chip or checkbox is selected:

FilterFormCell cell = findViewById(;
cell.setCellValueChangeListener(new FormCell.CellValueChangeListener<List<Integer>>() {
    public void cellChangeHandler(List<Integer> value) {
        // Value represents the list of selected chips or checkboxes by position.
        // Do something with value...

Last update: April 14, 2021