Interface IReaderDocumentSearch

Use this method if you have implemented your own IReaderDocumentSearchQueryMatcher that you wish to use when searching in ReaderDocuments.

If you want to do a basic text search, use createTextQuery instead.

When you provide the IReaderViewSearchAgent with a search query, the agent will use the query to search the visible ReaderDocuments in the ReaderView. For each found search match, the agent creates a ReaderViewAnnotation. The agent will continue to search, add and remove ReaderViewAnnotations as necessary when the ReaderView is navigated.

Note that, the search agent will not modify any options on the annotationLayer. You need to manually configure the ReaderViewAnnotationLayer by calling annotationLayer.setLayerOptions() and annotationLayer.setDefaultAnnotationOptions.

The following example shows how to highlight all search matches:

// Create the annotation layer used for highlighting search results.
const annotationLayer = readerView.createAnnotationLayer('searchHighlights');
annotationLayer.setLayerOptions({
    layerStyle: {
        'mix-blend-mode': 'multiply',
    },
});
annotationLayer.setDefaultAnnotationOptions({
    rangeStyle: {
        'background-color': 'lightblue',
    },
});

const readerDocumentSearch = readingSystemEngine.getReaderDocumentSearch();

// Create the query
const textQuery = readerDocumentSearch.createTextQuery('Paris');

// Create a search agent that will highlight all matches using the annotation layer.
const searchAgent = readerDocumentSearch.createReaderViewSearchAgent(annotationLayer);
searchAgent.setSearchQuery(textQuery);

If you want to support more advanced search queries, you can implement your own IReaderDocumentSearchQueryMatcher and use it with createCustomQuery() instead.

Note that, annotationLayer passed to createReaderViewSearchAgent() will not be destroyed by this method. Call readerView.destroyAnnotationLayer() with the annotationLayer to destroy it.