Tiny util to highlight given string in text.
API
This package contains only one function exported as getChunks
. This method searches a string of text for a set of search terms and returns an array of chunks that describe the matches found. For example:
import { getChunks } from 'highlight-string';
const text = 'Have a nice day!';
const substrings = ['a', 'day'];
const chunks = getChunks({
text,
substrings,
});
const highlightedText = chunks
.map(({ highlighted, text }) => (highlighted ? `<mark>${text}</mark>` : text))
.join('');
getChunks
Parameter | Required? | Default value | Type | Description |
---|---|---|---|---|
text | - | string |
Text to search and highlight | |
substrings | - | Array<string> |
Array of strings to search for | |
caseSensitive | false |
boolean |
Pass true if search should be case sensitive |
|
sanitize | - | (text: string) => string |
Sanitize function |
License
MIT