mirror of
https://github.com/Alfresco/alfresco-ng2-components.git
synced 2025-05-12 17:04:57 +00:00
81 lines
3.3 KiB
Markdown
81 lines
3.3 KiB
Markdown
---
|
|
Title: Search check list component
|
|
Added: v2.4.0
|
|
Status: Active
|
|
Last reviewed: 2024-05-13
|
|
---
|
|
|
|
# [Search check list component](../../../lib/content-services/src/lib/search/components/search-check-list/search-check-list.component.ts "Defined in search-check-list.component.ts")
|
|
|
|
Implements a [search widget](../../../lib/content-services/src/lib/search/models/search-widget.interface.ts) consisting of a list of checkboxes representing filters included in search query.
|
|
|
|
|
|
|
|
## Basic usage
|
|
|
|
```json
|
|
{
|
|
"search": {
|
|
"categories": [
|
|
{
|
|
"id": "checkList",
|
|
"name": "Check List",
|
|
"enabled": true,
|
|
"component": {
|
|
"selector": "check-list",
|
|
"settings": {
|
|
"pageSize": 5,
|
|
"operator": "OR",
|
|
"allowUpdateOnChange": true,
|
|
"options": [
|
|
{ "name": "Folder", "value": "TYPE:'cm:folder'" },
|
|
{ "name": "Document", "value": "TYPE:'cm:content'" }
|
|
]
|
|
}
|
|
}
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
### Settings
|
|
|
|
| Name | Type | Description |
|
|
| ---- | ---- | ----------- |
|
|
| operator | `string` | Logical operator to combine query fragments. Can be 'AND' or 'OR'. |
|
|
| options | `array` | Array of objects with `name` and `value` properties. Each object defines a checkbox, labelled with `name`, that adds the query fragment in `value` to the query when enabled. |
|
|
| allowUpdateOnChange | `boolean` | Enable/Disable the update fire event when text has been changed. By default is true. |
|
|
| hideDefaultAction | boolean | Show/hide the widget actions. By default is false. |
|
|
|
|
## Details
|
|
|
|
This widget displays a list of checkboxes, each of which toggles a particular query fragment in the search. See the [Search filter component](search-filter.component.md) for full details of how to use the widgets in a search query.
|
|
|
|
In the settings, the `options` array, defines the checkboxes that toggle the supplied query
|
|
fragments and the `operator` selects logical `AND` or `OR` to combine the fragments.
|
|
In the example above, if the user checks both boxes then the following fragment will be added
|
|
to the query:
|
|
|
|
```text
|
|
... (TYPE:'cm:folder' OR TYPE:'cm:content') ...
|
|
```
|
|
|
|
The component can be set to split a long checklist into separate pages of checkboxes
|
|
using the `pageSize` value as the number of boxes to show per page (default is 5).
|
|
When there is more than one page, the widget will display "Show more" and "Show less"
|
|
buttons as appropriate.
|
|
|
|
A "Clear all" button is also displayed at the bottom of the widget to clear all checked items in the list.
|
|
|
|
## See also
|
|
|
|
- [Search Configuration Guide](../../user-guide/search-configuration-guide.md)
|
|
- [Search filter chips component](search-filter-chips.component.md)
|
|
- [Search filter component](search-filter.component.md)
|
|
- [Search date range tabbed component](search-date-range-tabbed.component.md)
|
|
- [Search number range component](search-number-range.component.md)
|
|
- [Search radio component](search-radio.component.md)
|
|
- [Search slider component](search-slider.component.md)
|
|
- [Search text component](search-text.component.md)
|