Wyszukiwanie

Doconut Viewer zapewnia standardowe Wyszukiwanie przy użyciu tekstu wyodrębnionego przez przeglądarkę formatu lub przekierowania PDF opartego na tekście. Wymaga możliwości licencyjnej Search.

Włącz interfejs wyszukiwania

Wyszukiwanie jest modułem Viewer, a nie samodzielnym paskiem narzędzi. Pełna strona musi zawierać zasoby Viewer, pasek narzędzi Viewer, montaż Viewer oraz zainicjowany objViewer; wstążka Wyszukiwania jest następnie montowana i podłączana do tej samej instancji.

Wyszukiwanie i adnotacje są wbudowanymi funkcjami licencjonowanymi, a nie pakietami AddPlugin<T>(). Żądaj zasobów wyszukiwania z wstrzykniętego Viewer; ich tagi są emitowane tylko wtedy, gdy licencja zezwala na Wyszukiwanie.

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

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

Osadzona wstążka wywołuje te same metody JavaScript dostępne dla niestandardowego interfejsu użytkownika.

Utrzymaj pełną kompozycję Viewer widoczną w znacznikach, najpierw zainicjuj docViewer, a następnie podłącz licencjonowaną wstążkę:

<nav id="toolbar" aria-label="Document viewer controls">
    <!-- Kontrolki przeglądarki, w tym przycisk otwierający wyszukiwanie -->
</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: '/',
        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>

Komponent wstrzykuje grupy Find, Options i Results oraz obsługuje wyszukiwanie, czyszczenie, liczbę dopasowań i nawigację do poprzedniego/następnego dopasowania. Pasek narzędzi Viewer zarządzany przez hosta potrzebuje jedynie przełączenia go:

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

Jego publiczne API jest celowo małe:

Opcjonalne wywołanie zwrotne onToggle(isOpen) pozwala hostowi synchronizować przycisk Wyszukiwania, a onLayout umożliwia mu zmianę rozmiaru/dopasowanie widoku, gdy wysokość wstążki się zmienia. Aby zobaczyć sekwencję uruchamiania połączonych Viewer, Search i Annotation, zobacz Szybki start.

Wyszukiwanie z JavaScript

objViewer.Search(keyword, false, function (resultCount) {
    console.log('Matches:', resultCount);
});

Drugim argumentem jest dopasowanie całego słowa/dokładne. Po wywołaniu zwrotnym:

Ścieżka pośrednia używa search=<term> i exact=true|false i zwraca XML. Użyj API widgetu zamiast samodzielnie parsować tę wewnętrzną odpowiedź.

Sprawdź możliwości wyszukiwania

Odpowiedź inicjalizacji raportuje:

X-Doconut-Can-Search: 1

Po inicjalizacji, objViewer.CanSearch() udostępnia tę samą decyzję formatu/sesji. Zwraca false, gdy serwer wysyła 0; przed odpowiedzią lub przy starszym serwerze, który pomija nagłówek, domyślnie zwraca true.

Trzy niezależne bramki nie powinny być mylone:

Format może być technicznie przeszukiwalny, podczas gdy bieżąca licencja odmawia tej operacji.

Włącz wyodrębnianie per format

var token = await viewer.OpenDocumentAsync(path, new PdfConfig
{
    AllowSearch = true,
    AllowCopy   = true   // opcjonalnie: pozwala użytkownikowi zaznaczyć obszar i skopiować jego tekst
});

AllowSearch i AllowCopy istnieją na PdfConfig, WordConfig, ExcelConfig i PptConfig. Właściwości Office delegują do ich zagnieżdżonych PdfConfig. Oba domyślnie ustawione są na false.

Standardowe adaptery natywnego wyszukiwania istnieją dla PDF, Word, Excel, PowerPoint, TXT, Visio, email, EPUB i MHT. XPS domyślnie używa swojej ścieżki PDF. HTML i Microsoft Project korzystają z przekierowania PDF opartego na tekście:

// DefaultRender = false → przekształcony do PDF opartego na tekście → przeszukiwalny
var token = await viewer.OpenDocumentAsync(path, new HtmlConfig { DefaultRender = false });

Dla natywnych renderów, CanSearch() opisuje możliwości przeglądarki; nie gwarantuje, że konkretny dokument zawiera użyteczny tekst. PDF, którego strony są jedynie zeskanowanymi obrazami, może nadal zwracać zero natywnych wyników.

Normalne zachowanie wyszukiwania

Serwer próbuje źródeł wyszukiwania w następującej kolejności:

1. Wyniki z natywnego przeglądarki formatu.
2. Wstępnie zbudowany indeks wyszukiwania .srh.
3. Błąd/pusty wynik, gdy nie istnieje żadne źródło wyszukiwania.

Indeks .srh jest artefaktem wyszukiwania publikowanym razem z obrazami stron, gdy dokumenty są serwowane z udostępnionego magazynu, więc węzeł, który nigdy nie otworzył dokumentu, może nadal odpowiadać na wyszukiwania — zobacz Rozproszone wdrożenia.

CanSearch() może być prawdziwe dla przeglądarki z możliwością wyszukiwania, nawet gdy konkretny zeskanowany dokument nie ma warstwy tekstowej i dlatego nie zwraca dopasowań.

Licencjonowanie i zachowanie UI

Aktywna licencja Temporary/Demo przyznaje Wyszukiwanie w trakcie swojego aktywnego okresu. Brak licencji i starszy plik TRIAL nie przyznają możliwości Wyszukiwania. Bez Wyszukiwania:

• ReferenceCss i ReferenceScripts pomijają pakiety wyszukiwania.
• Pośrednik odrzuca wyszukiwanie zamiast zwracać licencjonowane wyniki.

Steruj widocznością niestandardowego UI z IDoconutLicenseService.IsCapabilityGranted(LicenseCapability.Search) i użyj CanSearch() dla oddzielnej decyzji formatu/sesji.

Rozwiązywanie problemów