mirror of
https://github.com/Alfresco/alfresco-ng2-components.git
synced 2025-05-12 17:04:57 +00:00
51 lines
1.8 KiB
Markdown
51 lines
1.8 KiB
Markdown
---
|
|
Added: v2.0.0
|
|
Status: Active
|
|
---
|
|
|
|
# Highlight Transform service
|
|
|
|
Adds HTML to a string to highlight chosen sections.
|
|
|
|
## Class members
|
|
|
|
### Methods
|
|
|
|
- **highlight**(text: `string`, search: `string`, wrapperClass: `string` = `"highlight"`): `HighlightTransformResult`<br/>
|
|
Searches for `search` string(s) within `text` and highlights all occurrences.
|
|
- _text:_ `string` - Text to search within
|
|
- _search:_ `string` - Text pattern to search for
|
|
- _wrapperClass:_ `string` - CSS class used to provide highlighting style
|
|
- **Returns** `HighlightTransformResult` - New text along with boolean value to indicate whether anything was highlighted
|
|
|
|
## Details
|
|
|
|
A typical use case for this service is to display the results from a search engine.
|
|
An excerpt of a retrieved document can be shown with the matching search terms
|
|
highlighted to indicate where they were found.
|
|
|
|
The service works by adding HTML <span> elements around all sections of text
|
|
that match the `search` string. You can specify multiple search strings at once by
|
|
separating them with spaces, so passing "Apple Banana Cherry" in `search` will
|
|
highlight any of those words individually. The <span> element includes a
|
|
`class` attribute which defaults to "highlight" but you can pass any class name
|
|
you like using the `wrapperClass` parameter.
|
|
|
|
The resulting text with HTML highlighting is returned within a [`HighlightTransformResult`](../../lib/core/services/highlight-transform.service.ts)
|
|
object:
|
|
|
|
```ts
|
|
interface HighlightTransformResult {
|
|
text: string;
|
|
changed: boolean;
|
|
}
|
|
```
|
|
|
|
The `changed` flag will be false if the search string was not found (ie, no highlighting
|
|
took place) and true otherwise.
|
|
|
|
## See also
|
|
|
|
- [Text highlight pipe](text-highlight.pipe.md)
|
|
- [Highlight directive](highlight.directive.md)
|