mirror of
https://github.com/Alfresco/alfresco-ng2-components.git
synced 2025-10-29 15:21:39 +00:00
83 lines
3.0 KiB
Markdown
83 lines
3.0 KiB
Markdown
---
|
|
Title: Search number range component
|
|
Added: v2.4.0
|
|
Status: Active
|
|
Last reviewed: 2024-05-03
|
|
---
|
|
|
|
# [Search number range component](../../../lib/content-services/src/lib/search/components/search-number-range/search-number-range.component.ts "Defined in search-number-range.component.ts")
|
|
|
|
Implements a [search widget](../../../lib/content-services/src/lib/search/models/search-widget.interface.ts) consisting of 2 inputs accepting numerical values, representing start and end of a numerical parameter's range used as a search query parameter.
|
|
|
|
|
|
|
|
## Basic usage
|
|
|
|
```json
|
|
{
|
|
"search": {
|
|
"categories": [
|
|
{
|
|
"id": "contentSizeRange",
|
|
"name": "Content Size (range)",
|
|
"enabled": true,
|
|
"component": {
|
|
"selector": "number-range",
|
|
"settings": {
|
|
"field": "cm:content.size",
|
|
"format": "[{FROM} TO {TO}]"
|
|
}
|
|
}
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
### Settings
|
|
|
|
| Name | Type | Description |
|
|
| ---- | ---- | ----------- |
|
|
| field | string | Field to to use |
|
|
| format | string | Value format. Uses string substitution to allow all sorts of [range queries](https://support.hyland.com/r/Alfresco/Alfresco-Search-Services/2.0/Alfresco-Search-Services/Using/Full-text-search-reference/Search-for-ranges). |
|
|
| hideDefaultAction | boolean | Show/hide the widget actions. By default is false. |
|
|
|
|
## Details
|
|
|
|
This component lets the user specify a range between two predefined numbers based on the
|
|
particular `field`. See the [Search filter component](search-filter.component.md) for full details of how to use widgets
|
|
in a search query.
|
|
|
|
#### Range query format
|
|
|
|
See the [Search for ranges](https://support.hyland.com/r/Alfresco/Alfresco-Governance-Services/23.4/Alfresco-Governance-Services/Using/Searching-records/Advanced-search-options) page in the ACS docs for more information about the date range format.
|
|
|
|
The `format` setting specifies how the date is displayed textually. Most of the format is
|
|
displayed as-is but you can use `{FROM}` and `{TO}` markers to interpolate the range limits
|
|
into the format string:
|
|
|
|
```json
|
|
"settings": {
|
|
"field": "cm:content.size",
|
|
"format": "[{FROM} TO {TO}]"
|
|
}
|
|
```
|
|
|
|
The format above would be displayed at runtime as follows:
|
|
|
|
```text
|
|
cm:content.size:[0 TO 100]
|
|
```
|
|
|
|
## 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 check list component](search-check-list.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)
|