(Added at v2.1)
The Filter widget allows you to limit the visibility of features in a layer. Only the features that meet the expression criteria will be visible in the map. Accordingly, other out-of-the-box widgets, if applicable, will respond to the change it makes in the layer.
Configure the Filter widget
This widget can be set to open automatically when an app starts. To enable this feature, click the Open this widget automatically when the app starts button on the widget, which turns it dark green.
- Hover over the widget and select Configure this widget button to open the configuration properties dialog box.
- Optionally click Change widget icon and replace it with your own image.
A file explorer window opens, allowing you to select a local image file to use as the widget icon.
- Click + New Filter and select a layer from the Layer drop-down list.
- Under the Info tab, name the filter in the Label text box.
- Browse to your local images to choose an icon for the filter. The default icon will apply if you don't specify it.
- Under the Expressions tab, click + Add expression.
- Click the field drop-down arrow and choose the field you want to filter against from the list.
- Click the operators drop-down arrow and choose an operator from the list.
Relative dates are supported now such as toady, yesterday, tomorrow, or in the last 5 days, weeks, months, etc.
- If you want to filter based on a specific value, click the setting gear icon, choose Value, and enter a value in the field. Click the box to the left of Ask for values if you want to set up an interactive expression. Enter information about the value in the Prompt field and a hint in the Hint field.
- If you want to compare the value in one field versus the value in another field, choose Field in the setting, click the drop-down arrow, and choose the field for your expression.
- If you want to filter based on a specific value in the field you've selected for your expression, choose Unique in the setting and select a unique value from your field. It also allows you to dynamically show the values based on the previous expressions or all other expressions regardless their orders. Enter information about the value in the Prompt field and a hint in the Hint field, and select how the values are listed.
Unique value filters require a 10.1 or later map service layer. The Unique option does not appear if you are creating a filter on a 10.0 or earlier service layer.
To display description for coded values when Values filtered by previous expressions or Values filtered by all other expressions is selected, the service must support the capability of query by statistics.
If you created an expression based on values or a unique value, you can set up an interactive expression by clicking the box to the left of Ask for values. You cannot ask for values on expressions based on a field.
- To create multiple expressions, or one or more sets of expressions, click + Add expression or Add set.
A set is a grouping of expressions, for example, Shelter capacity is greater than 200 and Status is open.
- Under Options tab, check the box left to Remove the preset layer filteres from the map if you don't want to carry over the filters in the map to your app.
- Check Apply this filter when the widget is opened if you want to apply the filter immediately when the widget is opened.
- Check the Collapse the filter expression (if any) when the widget is opened option to collapse the filter with Ask for values.
- To add another filter, repeat steps 1 through 10.
- Hover over the filter you created in the table to delete or order it.
- Optionally, if you want to zoom to features in the layer after the filters are applied, check Zoom to the layer once it's applied filters.
- Optionally, if you want end users to create their own filters, check Allow to create custom filters.
- Click OK to save and close the configuration.
Use the Filter widget
You can apply multiple filters simultaneously or apply an individual filter to the map.
- Click the Filter widget icon to open it.
- Click the filter you specify to limit features on the map. Notice that toggle button turns on after the filter is applied. Click the filter button again to remove the filtering from the map. You can also turn on and off the toggle button to apply or remove the filter.
- Type or choose a value in the text box if Ask for values is checked when the filter is created. Click the filter button to remove the filtering from the map. You may notice the arrow icon next to the filter. Click it to hide the input values.
- Click the Create custom filter icon under the bottom-right corner to define your own filters when applicable.