Filtering Data

The grid panels contain a filter control that allows you to refine the displayed results.

Open

The filter allows you to enter a value into the text field that will be used to refine the rows displayed in the grid based on the values stored in a single column, which can be chosen by clicking on the Filter button to the left of the text field.

Based upon what type of data is stored in each column, there are different filters that can be used to refine the rows. For example, if a column contains text then the column can be filtered based on matching characters in the text, but if the column contains numbers then the column can be filtered based on the values being less than a particular number.

Text

The filtering for text is case sensitive and is based on wildcards, using * as the wildcard character.

By default if you don’t include the wildcard character in the filter field one will be added to the end, so the filtering will only display rows that start with the text entered, but this can be disabled by setting stringFilterWildcard to false in the grid panel config.

If you want to display rows that contain the filter text in the middle then you need to add * to the start and the end. If you want to filter based on the text ending with the filter value then you just add the * at the start. To use an * in the filter, without it being interpreted as a wildcard placeholder, then you should precede it with the \ character. To use a \ in the filter before an * and have it interpreted as a slash followed by a wildcard, as opposed to an asterisk, use a double \.

If you don’t want to use a wildcard at all and search for the exact text entered then you can enclose the filter text in double-quotes, this will also disable the evaluation of \ and * characters and treat them and regular characters (and not escape or wildcard markers).

You can also combine two text filter if you want to match multiple values using | (pipe).

The following table shows the values the user enters and what the actual filter value will be, assuming stringFilterWildcard is true, which is the default, and what values the filter would match.

Numbers

If you’re filtering a column of numbers then just entering a number will filter the rows that match that value, there is no wildcard as for a text field. If you want to include numbers less than, less than or equal, greater than or greater than or equal then you can precede the value with <, <=, > or >=, or use <> for not equal.

You can also combine two numeric filters if you want only columns within a range, using a space between the values for and, and a | for or.

Dates

Dates are handled in a similar way to numbers, where entering a value will filter based on that value, but you can also specify range filters. You must also ensure that the date, time or timestamp value used in the filter is entered in a specific format to avoid confusion when parsing the date/time.