hit-highlighter

[![NPM version][npm-version-image]][npm-url]
[![NPM downloads][npm-downloads-image]][npm-url]
[![MIT License][license-image]][license-url]
[![Build Status][build-image]][build-url]
[![JavaScript Style Guide][standardjs-image]][standardjs-url]

A small and versatile hit highlighter for search engines running in the browser and Node.js. Language agnostic, meaning it supports all languages that can be split into words with code.

Takes a query array and where the values matches within the search result array, it adds hightight code. Goes well with words'n'numbers for extracting words (and numbers) from a string of text.

Also part of daq-proc, which is meant as a hassle free document and query processor for search engines running in the browser.

Breaing change

API is changed, both how to import for CJS and ESM and how to reference when using


`

$3


`javaScript
const { highlight } = require ('hit-highlight')
// highlight() available
`

$3

`javaScript
import { highlight } from 'hit-highlight'
// highlight() available
`

Usage

`javaScript
hightlight([query array], [item array], {prpoerties})
`

query and item are arrays of words. properties is optional to define, since you have defaultProperties:
`javaScript
defaultProperties = {
itemMaxWords: 0,
truncateStart: '',
truncateEnd: '',
hitPaddingMin: 5,
highlightStart: '',
highlightEnd: '',
divider: ' '
}
`

If you want to overwrite anything, i.e. maximum words to show in an item, you can do:
`javaScript
hightlight([query array], [item array], {itemMaxWords: 100})
`

$3

`javaScript
const query = ['interesting', 'words']
const item = ['some', 'interesting', 'words', 'to', 'remember']

highlight(query, item)

// returns:
// 'some interesting words to remember '
`

$3

`javaScript
const query = ['interesting', 'words']
const item = ['some', 'interesting', 'words', 'to', 'remember']
const properties = { highlightStart: '', highlightEnd: '' }

highlight(query, item, properties)

// returns:
// 'some interesting words to remember '
`

$3

`javaScript
const query = ['no', 'hits']
const item = ['some', 'interesting', 'words', 'to', 'remember']

highlight(query, item)

// returns:
// 'some interesting words to remember '
``

[license-image]: http://img.shields.io/badge/license-MIT-blue.svg?style=flat
[license-url]: LICENSE
[npm-url]: https://npmjs.org/package/hit-highlighter
[npm-version-image]: https://img.shields.io/npm/v/hit-highlighter.svg?style=flat
[npm-downloads-image]: https://img.shields.io/npm/dm/hit-highlighter.svg?style=flat
[build-url]: https://github.com/eklem/hit-highlighter/actions/workflows/tests.yml
[build-image]: https://github.com/eklem/hit-highlighter/actions/workflows/tests.yml/badge.svg
[standardjs-url]: https://standardjs.com
[standardjs-image]: https://img.shields.io/badge/code_style-standard-brightgreen.svg?style=flat-square