mirror of
https://github.com/Alfresco/alfresco-ng2-components.git
synced 2025-07-24 17:32:15 +00:00
69 lines
2.7 KiB
Markdown
69 lines
2.7 KiB
Markdown
---
|
|
Title: Search radio component
|
|
Added: v2.4.0
|
|
Status: Active
|
|
Last reviewed: 2018-08-10
|
|
---
|
|
|
|
# [Search radio component](../../lib/content-services/search/components/search-radio/search-radio.component.ts "Defined in search-radio.component.ts")
|
|
|
|
Implements a radio button list widget for the [Search Filter component](../content-services/search-filter.component.md).
|
|
|
|
|
|
|
|
## Basic usage
|
|
|
|
```json
|
|
{
|
|
"search": {
|
|
"categories": [
|
|
{
|
|
"id": "queryType",
|
|
"name": "Type",
|
|
"enabled": true,
|
|
"component": {
|
|
"selector": "radio",
|
|
"settings": {
|
|
"field": null,
|
|
"pageSize": 5,
|
|
"options": [
|
|
{ "name": "None", "value": "" },
|
|
{ "name": "All", "value": "TYPE:'cm:folder' OR TYPE:'cm:content'" },
|
|
{ "name": "Folder", "value": "TYPE:'cm:folder'" },
|
|
{ "name": "Document", "value": "TYPE:'cm:content'" }
|
|
]
|
|
}
|
|
}
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
### Settings
|
|
|
|
| Name | Type | Description |
|
|
| ---- | ---- | ----------- |
|
|
| options | `array` | Array of objects with `name` and `value` properties. Each object defines a radio button, labelled with `name`, that adds the query fragment in `value` to the query when enabled. |
|
|
|
|
## Details
|
|
|
|
This component displays a list of radio buttons, each of which toggles a particular
|
|
query fragment in the search. This behaviour is very similar to that of the
|
|
[Search check list component](../content-services/search-check-list.component.md) except only one item at a time can be selected. See the
|
|
[Search filter component](../content-services/search-filter.component.md) for full details of how to use the widgets in a search query.
|
|
|
|
The component can be set to split a long list of buttons into separate pages
|
|
using the `pageSize` value as the number of buttons 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.
|
|
|
|
## See also
|
|
|
|
- [Search filter component](../content-services/search-filter.component.md)
|
|
- [Search check list component](../content-services/search-check-list.component.md)
|
|
- [Search date range component](../content-services/search-date-range.component.md)
|
|
- [Search number range component](../content-services/search-number-range.component.md)
|
|
- [Search slider component](../content-services/search-slider.component.md)
|
|
- [Search text component](../content-services/search-text.component.md)
|