Поиск

Doconut Viewer предоставляет обычный Search, используя текст, извлечённый просмотрщиком формата, или перенаправление в текстовый PDF. Для этого требуется возможность лицензии Search.

Включить пользовательский интерфейс поиска

Search — это модуль Viewer, а не отдельная панель инструментов. Полная страница должна включать ресурсы Viewer, панель инструментов Viewer, монтирование Viewer и инициализированный objViewer; затем Ribbon Search монтируется и привязывается к тому же экземпляру.

Search и аннотация являются встроенными лицензированными функциями, а не пакетами AddPlugin<T>(). Запросите ресурсы поиска у внедрённого Viewer; их теги генерируются только когда лицензия предоставляет Search.

@Html.Raw(Viewer.ReferenceCss(new CssConfig
{
    IncludeViewerCss = true,
    IncludeSearchCss = true
}))

@Html.Raw(Viewer.ReferenceScripts(new ScriptConfig
{
    IncludeJQuery = true,
    IncludeViewerScripts = true,
    IncludeSearchScripts = true,
    IncludeSearchBar = true
}))

Встроенный ribbon вызывает те же методы JavaScript, доступные пользовательскому UI.

Сохраните полную композицию Viewer в разметке, сначала инициализируйте docViewer, а затем присоедините лицензированный Ribbon:

<nav id="toolbar" aria-label="Элементы управления просмотром документа">
    <!-- Элементы управления Viewer, включая кнопку, открывающую поиск -->
</nav>
<div id="searchBarMount"></div>
<div id="divDocViewer"><div id="div_ctlDoc"></div></div>

<script>
    let searchBar = null;
    let currentToken = '';

    const objViewer = $('#div_ctlDoc').docViewer({
        BasePath: '/doconut',
        ResPath: '/doconut-res/images'
    });

    @if (Viewer.IsSearchEnabled)
    {
        <text>
    searchBar = $('#searchBarMount').doconutSearchBar({
        docId: 'ctlDoc',
        getRequestParams: () => ({ token: currentToken }),
        onStatus: (message) => console.log(message),
        onToast: (message, type) => console.log(type, message),
        onLayout: () => requestAnimationFrame(() => objViewer.Refit())
    });
    searchBar.attach(objViewer);
        </text>
    }
</script>

Компонент внедряет группы Find, Options и Results и обрабатывает поиск, очистку, подсчёт совпадений и навигацию по предыдущему/следующему совпадению. Панель инструментов Viewer, принадлежащая хосту, только переключает её:

searchBar.isOpen() ? searchBar.close() : searchBar.open();

Его публичный API намеренно небольшой:

Опциональный обратный вызов onToggle(isOpen) позволяет хосту синхронизировать кнопку Search, а onLayout — изменить размер/подогнать viewer, когда высота Ribbon меняется. Для последовательности запуска комбинированного Viewer, Search и Annotation см. Быстрый старт.

Поиск из JavaScript

objViewer.Search(keyword, false, function (resultCount) {
    console.log('Совпадения:', resultCount);
});

Второй аргумент отвечает за поиск целых слов/точное совпадение. После обратного вызова:

Маршрут посредника использует search=<term> и exact=true|false и возвращает XML. Используйте API виджета, а не парсите внутренний ответ самостоятельно.

Проверка возможности поиска

Ответ инициализации сообщает:

X-Doconut-Can-Search: 1

После инициализации objViewer.CanSearch() выдаёт тот же verdict формата/сессии. Он возвращает false, когда сервер отправляет 0; до получения ответа или при старом сервере, который опускает заголовок, значение по умолчанию — true.

Три независимых «ворота» не следует путать:

Формат может быть технически searchable, тогда как текущая лицензия запрещает операцию.

Включить извлечение по формату

var token = await viewer.OpenDocumentAsync(path, new PdfConfig
{
    AllowSearch = true,
    AllowCopy   = true   // опционально: позволяет пользователю выделять область и копировать её текст
});

AllowSearch и AllowCopy присутствуют в PdfConfig, WordConfig, ExcelConfig и PptConfig. Свойства Office делегируют своим вложенным PdfConfig. По умолчанию оба значения false.

Нативные адаптеры поиска существуют для PDF, Word, Excel, PowerPoint, TXT, Visio, email, EPUB и MHT. XPS использует свой PDF‑путь по умолчанию. HTML и Microsoft Project выигрывают от перенаправления в текстовый PDF:

// DefaultRender = false → преобразуется в текстовый PDF → доступен поиск
var token = await viewer.OpenDocumentAsync(path, new HtmlConfig { DefaultRender = false });

Для нативных рендереров CanSearch() описывает возможности viewer; это не гарантирует, что конкретный документ содержит пригодный к использованию текст. PDF, страницы которого представляют только отсканированные изображения, может всё равно возвращать ноль нативных результатов.

Обычное поведение поиска

Сервер пытается использовать источники поиска в следующем порядке:

1. Нативные результаты ISearchableViewer.
2. Предварительно построенный поисковый индекс .srh.
3. Ошибка/пустой результат, когда источник поиска отсутствует.

CanSearch() может быть true для searchable viewer, даже если у конкретного документа нет текстового слоя и поэтому он не возвращает совпадений.

Лицензирование и поведение UI

Активная временная/демо‑лицензия предоставляет Search в течение своего активного периода. Отсутствующая лицензия и устаревший файл TRIAL не предоставляют возможности Search. Без Search:

• ReferenceCss и ReferenceScripts исключают пакеты поиска.
• Промежуточный слой отклоняет поиск вместо возврата лицензированных результатов.

Управляйте видимостью пользовательского UI через IDoconutLicenseService.IsCapabilityGranted(LicenseCapability.Search) и используйте CanSearch() для отдельного verdict формата/сессии.

Устранение неполадок