Filtering Repeater Rows

In this tutorial, you'll learn how to filter repeater widgets to only display rows that meet certain criteria.

Note

Click here to download the completed RP file for this tutorial.

1. Widget Setup

Open a new RP file and open Page 1 on the canvas.
Drag a rectangle widget onto the canvas, right-click it, and select Create Repeater from the context menu.
Add two rows, and then edit the Column1 cells to be numbered from 1-5
Set the text on the button to Add Filter.

Select the "Add Filter" button widget and click New Interaction in the Interactions pane.
Select the Click or Tap event in the list that appears, and then select the Add Filter action.
Select the repeater widget in the Target dropdown.
In the Name field, enter Less than 4.
In the Rule field, enter [[Item.Column1 < 4]]. This bracketed expression will filter out any rows whose Column1 values are less than 4.
Click OK to save the action.

Preview the page and click the "Add Filter" button to filter the repeater. The "4" and "5" rectangles should disappear.

Back in Axure RP, add a text field widget to the canvas.
With the text field selected, click New Interaction in the Interactions pane.
Select the Text Changed event in the list that appears, and then select the Add Filter action.
Select the repeater widget in the Target dropdown.
In the Name field, enter Less than user input.
In the Rule field, enter [[Item.Column1 < This.text]]. This bracketed expression will filter out any rows whose Column0 values are less than the value entered in the text field.
Click OK to save the action.

Preview the page again and enter 4 in the text field. The repeater should only display rectangles "3" and below.
Enter 5 in the text field. The repeater should now display rectangles "4" and below.

Back in Axure RP, drag another button widget onto the canvas and set its text to Remove Filter.
With the button selected, click New Interaction in the Interactions pane.
Select the Click or Tap event in the list that appears, and then select the Remove Filter action.
Select the repeater widget in the Target dropdown.
Select the All radio button and click OK to save the action.

Note

To remove only one specific filter, you can select the second radio button and enter the filter's name in the text field. This can be useful when you have multiple filters applied to a repeater at the same time.