inteligr8/alfresco-ng2-components
1
0
Fork 0
mirror of https://github.com/Alfresco/alfresco-ng2-components.git synced 2025-05-12 17:04:57 +00:00
Code Issues Packages Projects Releases Wiki Activity
alfresco-ng2-components/docs/core/highlight-transform.service.md

1.5 KiB
Raw Blame History

Added, Status
Added Status
v2.0.0 Active

Highlight Transform service

Adds HTML to a string to highlight chosen sections.

Methods

  • highlight(text: string, search: string, wrapperClass: string = 'highlight'): HightlightTransformResult
    Searches for search string(s) within text and highlights all occurrences.
    • text - Text to search within
    • search - Text pattern to search for
    • wrapperClass - CSS class used to provide highlighting style

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 HightlightTransformResult object:

interface HightlightTransformResult {
    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