Skip to main content
Version: Version 5 beta

Interface: Search

Groups all the API actions related to search functionality.

Properties

addEventListener()

addEventListener: (eventName, callback) => void

Adds an event listener to the different search events.

Parameters

eventName: "toggled" | "searchResultClicked" | "settingsClicked" | "caseSensitiveToggled" | "regularExpressionToggled" | "clearSearchPanelInputClicked"

The event name (e.g., 'toggled', 'searchResultClicked', etc.).

callback: (active) => void | (searchResult) => void | () => void | (caseSensitive) => void | (regularExpression) => void | () => void

The callback function to execute when the event is triggered.

Returns

void

Example

PdfToolsViewerApi.search.addEventListener('toggled', () => { console.log('callback') });


emitCaseSensitiveToggled()

emitCaseSensitiveToggled: (caseSensitive) => void

Triggers an event indicating that the search case-sensitive checkbox has been toggled.

Parameters

caseSensitive: boolean

true if case sensitivity has been enabled, false otherwise.

Returns

void

Example

PdfToolsViewerApi.search.emitCaseSensitiveToggled(false);


emitClearSearchPanelInputClicked()

emitClearSearchPanelInputClicked: () => void

Triggers an event indicating that the clear search panel input button has been clicked.

Returns

void

Example

PdfToolsViewerApi.search.emitClearSearchPanelInputClicked();


emitRegularExpressionToggled()

emitRegularExpressionToggled: (regularExpression) => void

Triggers an event indicating that the search regular expression checkbox has been toggled.

Parameters

regularExpression: boolean

true if regular expressions have been enabled, false otherwise.

Returns

void

Example

PdfToolsViewerApi.search.emitRegularExpressionToggled(true);


emitSearchResultClicked()

emitSearchResultClicked: (sr) => void

Triggers an event indicating that a search result has been clicked.

Parameters

sr: any

The search result that was clicked.

Returns

void

Example

PdfToolsViewerApi.search.emitSearchResultClicked(sr);


emitSettingsClicked()

emitSettingsClicked: () => void

Triggers an event indicating that the search settings have been clicked.

Returns

void

Example

PdfToolsViewerApi.search.emitSettingsClicked();


emitToggled()

emitToggled: (active) => void

Triggers an event indicating that the search panel has been toggled (opened or closed).

Parameters

active: boolean

true if the search panel has been opened, false otherwise.

Returns

void

Example

PdfToolsViewerApi.search.emitToggled(true);


removeEventListener()

removeEventListener: (eventName, callback) => void

Removes an event listener attached to a search event.

Parameters

eventName: "toggled" | "searchResultClicked" | "settingsClicked" | "caseSensitiveToggled" | "regularExpressionToggled" | "clearSearchPanelInputClicked"

The event name (e.g., 'toggled', 'searchResultClicked', etc.).

callback: (active) => void | (searchResult) => void | () => void | (caseSensitive) => void | (regularExpression) => void | () => void

The callback function to remove from the event listener.

Returns

void

Example

PdfToolsViewerApi.search.removeEventListener('toggled', callback);