mirror of
https://github.com/Alfresco/alfresco-ng2-components.git
synced 2025-05-12 17:04:57 +00:00
70 lines
2.6 KiB
Markdown
70 lines
2.6 KiB
Markdown
---
|
|
Title: Search text component
|
|
Added: v2.4.0
|
|
Status: Active
|
|
Last reviewed: 2024-05-13
|
|
---
|
|
|
|
# [Search text component](../../../lib/content-services/src/lib/search/components/search-text/search-text.component.ts "Defined in search-text.component.ts")
|
|
|
|
Implements a [search widget](../../../lib/content-services/src/lib/search/models/search-widget.interface.ts) consisting of a input representing a value used in search query to specify field contents.
|
|
|
|
|
|
|
|
## Basic usage
|
|
|
|
```json
|
|
{
|
|
"search": {
|
|
"categories": [
|
|
{
|
|
"id": "queryName",
|
|
"name": "Name",
|
|
"enabled": true,
|
|
"expanded": true,
|
|
"component": {
|
|
"selector": "text",
|
|
"settings": {
|
|
"searchPrefix": "",
|
|
"searchSuffix": "",
|
|
"pattern": "cm:name:'(.*?)'",
|
|
"field": "cm:name",
|
|
"placeholder": "Enter the name",
|
|
"allowUpdateOnChange": true
|
|
}
|
|
}
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
### Settings
|
|
|
|
| Name | Type | Description |
|
|
| ---- | ---- | ----------- |
|
|
| field | string | Field to apply the query fragment to. Required value |
|
|
| pattern | string | Regular expression pattern to restrict the format of the input text |
|
|
| placeholder | string | Text displayed in the widget when the input string is empty |
|
|
| searchSuffix | string | Text to append always in the search of a string |
|
|
| searchPrefix | string | Text to prepend always in the search of a string |
|
|
| 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 component lets the user add a text value to search for in the specified
|
|
`field`. See the [Search filter component](search-filter.component.md) for full
|
|
details of how to use widgets in a search query.
|
|
|
|
## 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)
|