Text Filter

Use the Core text filter for names, labels, codes, descriptions, and other values that users should match by typing. It needs no Pro plugin.

Source code

grid.columns = [{ prop: 'name', name: 'Name', filter: 'string' }];
grid.filter = true;

return [
  { name: 'Anna' },
  { name: 'John' },
  { name: 'Diana' },
  { name: 'Marco' },
];

Quick start

1
const grid = document.querySelector('revo-grid')!;
2

3
grid.columns = [
4
  { prop: 'name', name: 'Name', filter: 'string' },
5
  { prop: 'status', name: 'Status', filter: 'string' },
6
];
7
grid.filter = true;
8
grid.source = [
9
  { name: 'Anna Silva', status: 'Open' },
10
  { name: 'John Smith', status: 'Pending' },
11
];

Open a column’s filter button, choose Contains, enter text, and apply. Text equality, begins-with, and contains matching are case-insensitive.

Operators

Saved ID	Popup label	Needs a value
`contains`	Contains	Yes
`notContains`	Does not contain	Yes
`begins`	Begins with	Yes
`eq`	Equal	Yes
`notEq`	Not equal	Yes
`empty`	Is blank	No
`notEmpty`	Is not blank	No

An empty text input is a no-op. Blank operators use the grid’s source-aware blank policy, not a display-string conversion.

Start with a condition

1
grid.filter = {
2
  multiFilterItems: {
3
    status: [{ id: 1, type: 'eq', value: 'Open', relation: 'and' }],
4
  },
5
};

Combine alternatives within one column with or:

1
grid.filter = {
2
  multiFilterItems: {
3
    status: [
4
      { id: 1, type: 'eq', value: 'Open', relation: 'or' },
5
      { id: 2, type: 'eq', value: 'Pending', relation: 'and' },
6
    ],
7
  },
8
};

Different columns always combine with AND in multiFilterItems. Use Filter AST for cross-column OR.

Filter a normalized value

Conditions receive cellParser output when the stored model needs normalization:

1
grid.columns = [
2
  {
3
    prop: 'customerCode',
4
    name: 'Customer code',
5
    filter: 'string',
6
    cellParser: (model, column) => String(model[column.prop] ?? '').trim(),
7
  },
8
];

Common mistakes

Use eq, not the numeric eqN, for a text column.
Do not expect text conditions on different columns to combine with OR.
Use Selection Filter when users should choose from repeated known values instead of typing.
Use Token List when users paste several exact values at once.