Class CodeMirrorSearchHighlighter

Helper class to highlight texts in a code mirror editor.

Highlighted texts (aka matches) must be provided through the matches attributes.

NOTES:

to retain the selection visibility drawSelection extension is needed.
highlighting starts from the cursor (if editor is focused and from is set to 'auto', cursor moved, or from argument is set to 'selection' or 'selection-start'), or from last "current" match otherwise.
currentIndex is the (readonly) source of truth for the current match.

Constructors

constructor

new CodeMirrorSearchHighlighter(editor): CodeMirrorSearchHighlighter
Constructor
Parameters
- editor: null | CodeMirrorEditor
  The CodeMirror editor
Returns CodeMirrorSearchHighlighter
- Defined in packages/codemirror/src/searchprovider.ts:551

Properties

`Private` _cm

_cm: null | CodeMirrorEditor

`Private` _current

_current: null | ISearchMatch = null

`Private` _currentIndex

_currentIndex: null | number

`Private` _currentMark

_currentMark: Decoration

`Private` _domEventHandlers

_domEventHandlers: Extension

`Private` _highlightEffect

_highlightEffect: StateEffectType<IEffectValue>

`Private` _highlightField

_highlightField: StateField<DecorationSet>

`Private` _highlightMark

_highlightMark: Decoration

`Private` _matches

_matches: ISearchMatch[]

`Private` _protectSelection

_protectSelection: boolean

Accessors

currentIndex

get currentIndex(): null | number
The current index of the selected match.

Returns null | number
- Defined in packages/codemirror/src/searchprovider.ts:627

matches

get matches(): ISearchMatch[]
The list of matches

Returns ISearchMatch[]
- Defined in packages/codemirror/src/searchprovider.ts:634
set matches(v): void
Parameters
- v: ISearchMatch[]
Returns void
- Defined in packages/codemirror/src/searchprovider.ts:637

protectSelection

get protectSelection(): boolean
Whether the cursor/selection should not be modified.

Returns boolean
- Defined in packages/codemirror/src/searchprovider.ts:653
set protectSelection(v): void
Parameters
- v: boolean
Returns void
- Defined in packages/codemirror/src/searchprovider.ts:656

Methods

`Private` _findNext

_findNext(reverse, from?): null | number
Parameters
- reverse: boolean
- from: SearchStartAnchor = 'auto'
Returns null | number
- Defined in packages/codemirror/src/searchprovider.ts:833

`Private` _highlightCurrentMatch

_highlightCurrentMatch(options?): void
Parameters
- Optional options: IHighlightMatchOptions
Returns void
- Defined in packages/codemirror/src/searchprovider.ts:785

`Private` _refresh

_refresh(): void
Returns void
- Defined in packages/codemirror/src/searchprovider.ts:815

`Private` _selectCurrentMatch

_selectCurrentMatch(scroll?): void
Parameters
- scroll: boolean = true
Returns void
- Defined in packages/codemirror/src/searchprovider.ts:739

clearHighlight

clearHighlight(): void
Clear all highlighted matches

Returns void
- Defined in packages/codemirror/src/searchprovider.ts:664

endQuery

endQuery(): Promise<void>
Clear the highlighted matches.

Returns Promise<void>
- Defined in packages/codemirror/src/searchprovider.ts:672

highlightNext

highlightNext(options?): Promise<undefined | ISearchMatch>
Highlight the next match
Parameters
- Optional options: IHighlightAdjacentMatchOptions
Returns Promise<undefined | ISearchMatch>
The next match if available
- Defined in packages/codemirror/src/searchprovider.ts:690

highlightPrevious

highlightPrevious(options?): Promise<undefined | ISearchMatch>
Highlight the previous match
Parameters
- Optional options: IHighlightAdjacentMatchOptions
Returns Promise<undefined | ISearchMatch>
The previous match if available
- Defined in packages/codemirror/src/searchprovider.ts:707

setEditor

setEditor(editor): void
Set the editor
Parameters
- editor: CodeMirrorEditor
  Editor
Returns void
- Defined in packages/codemirror/src/searchprovider.ts:724