Vyhledávání
Nativní textové vyhledávání v kompozici Vieweru
Prohlížeč Doconut poskytuje běžné vyhledávání pomocí textu extrahovaného formátovým prohlížečem nebo textovým přesměrováním PDF. Vyžaduje schopnost licence Search.
Povolení uživatelského rozhraní vyhledávání
Vyhledávání je modul Vieweru, nikoli samostatná lišta nástrojů. Kompletní stránka musí zahrnovat zdroje Vieweru, lištu nástrojů Vieweru, připojení Vieweru a inicializovaný objViewer; poté je Ribbon pro vyhledávání připojen a připojen k téže instanci.
Vyhledávání a anotace jsou vestavěné licencované funkce, nikoli balíčky AddPlugin<T>(). Požádejte o vyhledávací zdroje z injektovaného Viewer; jejich značky jsou generovány pouze tehdy, když licence povoluje Vyhledávání.
@Html.Raw(Viewer.ReferenceCss(new CssConfig
{
IncludeViewerCss = true,
IncludeSearchCss = true
}))
@Html.Raw(Viewer.ReferenceScripts(new ScriptConfig
{
IncludeJQuery = true,
IncludeViewerScripts = true,
IncludeSearchScripts = true,
IncludeSearchBar = true
}))Vložený ribbon volá stejné JavaScriptové metody, které jsou k dispozici pro vlastní uživatelské rozhraní.
Udržujte kompletní kompozici Vieweru viditelnou v markupu, nejprve inicializujte docViewer a poté připojte licencovaný Ribbon:
<nav id="toolbar" aria-label="Document viewer controls">
<!-- Ovládací prvky prohlížeče, včetně tlačítka, které otevírá vyhledávání -->
</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>Serverová if má význam: bez schopnosti Vyhledávání ReferenceScripts vynechává skript Ribbonu, takže nechráněné volání doconutSearchBar(...) by vyvolalo výjimku a zastavilo načtení stránky prohlížeče.
Komponenta injektuje skupiny Find, Options a Results a zpracovává vyhledávání, čištění, počty shod a navigaci na předchozí/ následující shodu. Lišta nástrojů Vieweru vlastněná hostitelem ji stačí přepnout:
searchBar.isOpen() ? searchBar.close() : searchBar.open();Jeho veřejné API je úmyslně malé:
| Metoda | Účel |
|---|---|
attach(objViewer) | Připojí Ribbon k inicializovanému prohlížeči; vyžadováno jednou |
open() / close() | Zobrazí nebo skryje Ribbon; zavření také vymaže zvýraznění |
reset() | Vymaže aktuální termín, počet výsledků a zvýraznění |
isOpen() | Nahlásí, zda je Ribbon viditelný |
setStatus(message) | Přepošle stavovou zprávu přes nakonfigurovaný callback |
Volitelný callback onToggle(isOpen) umožňuje hostiteli synchronizovat jeho tlačítko Vyhledávání a onLayout mu umožňuje změnit velikost/přizpůsobit prohlížeč, když Ribbon změní výšku. Pro sekvenci spouštění kombinovaného Vieweru, Vyhledávání a Anotace viz Rychlý start.
Vyhledávání z JavaScriptu
objViewer.Search(keyword, false, function (resultCount) {
console.log('Matches:', resultCount);
});Druhý argument určuje vyhledávání celých slov/přesnou shodu. Počet shod přichází v callbacku: Search sám jde na server a nevrací nic užitečného, takže var n = objViewer.Search(keyword, false) vždy čte undefined — a stránka vytvořená tímto způsobem hlásí „nic nenalezeno“, zatímco prohlížeč zvýrazňuje shody. Po callbacku:
| Metoda | Výsledek |
|---|---|
SearchMatchCount() | Celkový počet jednotlivých shod v dokumentu. |
SearchSummary(false) | [pageNumber, matchCount] položky bez překreslování. |
SearchSummary(true) | Stejný souhrn a vykresluje zvýraznění stránky/miniaturního náhledu. |
GotoSearchMatch(index) | Naviguje na index shody počítaný od nuly. |
Middleware trasa používá search=<term> a exact=true|false a vrací XML. Použijte widgetové API místo vlastního parsování této interní odpovědi.
Zkontrolovat schopnost vyhledávání
Inicializační odpověď hlásí:
X-Doconut-Can-Search: 1Po inicializaci objViewer.CanSearch() zveřejňuje stejný výsledek formátu/sesze. Vrací false, když server pošle 0; před odpovědí, nebo se starším serverem, který hlavičku vynechává, výchozí je true.
Tři nezávislé brány nesmí být zaměněny:
| Brána | Otázka |
|---|---|
CanSearch() / response header | Má vyřešený prohlížeč nativní index/cestu pro vyhledávání? |
AllowSearch | Požadoval tento formát konfiguraci extrakce textu tam, kde existuje přepínač? |
LicenseCapability.Search | Je aplikace oprávněna provádět vyhledávání a přijímat UI balíčky? |
Formát může být technicky vyhledávatelný, zatímco aktuální licence operaci zakazuje.
Povolit extrakci podle formátu
var token = await viewer.OpenDocumentAsync(path, new PdfConfig
{
AllowSearch = true,
AllowCopy = true // volitelné: umožňuje uživateli táhnout oblast a zkopírovat její text
});AllowSearch a AllowCopy existují na PdfConfig, WordConfig, ExcelConfig a PptConfig. Vlastnosti Office delegují na jejich vnořené PdfConfig. Oba mají výchozí hodnotu false.
Existují běžné nativní vyhledávací adaptéry pro PDF, Word, Excel, PowerPoint, TXT, Visio, e‑mail, EPUB a MHT. XPS používá ve výchozím nastavení svou PDF cestu. HTML a Microsoft Project těží z přesměrování na textový PDF:
// DefaultRender = false → převádí se na textový PDF → vyhledávatelný
var token = await viewer.OpenDocumentAsync(path, new HtmlConfig { DefaultRender = false });Pro nativní renderery CanSearch() popisuje schopnost prohlížeče; nezaručuje, že konkrétní dokument obsahuje použitelné texty. PDF, jehož stránky jsou pouze naskenované obrázky, může stále produkovat nulové nativní výsledky.
Normální chování vyhledávání
Server zkouší zdroje vyhledávání v tomto pořadí:
- Výsledky z nativního prohlížeče formátu.
- Předpřipravený index vyhledávání
.srh. - Chyba/prázdný výsledek, když neexistuje žádný zdroj vyhledávání.
Index .srh je artefakt vyhledávání publikovaný spolu s obrázky stránek, když jsou dokumenty poskytovány ze sdíleného úložiště, takže uzel, který dokument nikdy neotevřel, může stále odpovídat na vyhledávání — viz Distribuovaná nasazení.
CanSearch() může být pravda pro vyhledávatelný prohlížeč i když konkrétní naskenovaný dokument nemá textovou vrstvu a tudíž nevrací žádné shody.
Licencování a chování UI
Aktivní dočasná/demo licence poskytuje vyhledávání během svého platného období. Chybějící licence a starý soubor TRIAL neposkytují žádnou schopnost vyhledávání. Bez vyhledávání:
ReferenceCssaReferenceScriptsvynechávají vyhledávací balíčky.- Middleware odmítá vyhledávání místo vracení licencovaných výsledků.
Řiďte viditelnost vlastního UI z IDoconutLicenseService.IsCapabilityGranted(LicenseCapability.Search) a použijte CanSearch() pro samostatný výsledek formátu/sesze.
Odstraňování potíží
| Příznak | Kontrola |
|---|---|
| Vyhledávací lišta chybí | Schopnost vyhledávání a IncludeSearchCss/IncludeSearchScripts/IncludeSearchBar |
CanSearch() je nepravda | Prohlížeč formátu, vybraná cesta DefaultRender a hlavička inicializační odpovědi |
| Vyhledávání vrací nulu pro naskenovaný PDF | Dokument nemá textovou vrstvu; použijte zdroj s textem nebo projekci PDF, která zachovává text |
| Vyhledávání funguje, ale zvýraznění jsou posunutá | Cesta renderování, rozlišení, transformace dokumentu a extrahované rámečky slov |
Byla tato stránka užitečná?