Pencarian

Pencarian teks asli dalam komposisi Penampil

Penampil Doconut menyediakan Pencarian normal menggunakan teks yang diekstrak oleh penampil format atau pengalihan PDF berbasis teks. Ini memerlukan kemampuan lisensi Search.

Aktifkan UI pencarian

Pencarian adalah modul Penampil, bukan bilah alat terpisah. Halaman lengkap harus menyertakan sumber daya Penampil, bilah alat Penampil, pemasangan Penampil, dan objViewer yang telah diinisialisasi; Ribbon Pencarian kemudian dipasang dan dilampirkan ke instance yang sama itu.

Pencarian dan anotasi adalah fitur berlisensi bawaan, bukan paket AddPlugin<T>(). Minta sumber daya pencarian dari Viewer yang disuntikkan; tag mereka hanya dihasilkan ketika lisensi memberikan Pencarian.

html
@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 yang disematkan memanggil metode JavaScript yang sama tersedia untuk UI khusus.

Pertahankan komposisi Penampil lengkap terlihat dalam markup, inisialisasi docViewer terlebih dahulu, lalu lampirkan Ribbon berlisensi:

html
<nav id="toolbar" aria-label="Document viewer controls">
    <!-- Kontrol penampil, termasuk tombol yang membuka pencarian -->
</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>

Hal if di sisi server penting: tanpa kemampuan Pencarian, ReferenceScripts menghilangkan skrip Ribbon, sehingga panggilan doconutSearchBar(...) yang tidak dilindungi akan melempar error dan menghentikan halaman penampil dari memulai.

Komponen menyuntikkan grup Temukan, Opsi, dan Hasil serta menangani pencarian, pembersihan, hitungan kecocokan, dan navigasi kecocokan sebelumnya/berikutnya. Bilah alat Penampil yang dimiliki host hanya perlu mengalihkannya:

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

API publiknya sengaja kecil:

MetodeTujuan
attach(objViewer)Menghubungkan Ribbon ke penampil yang telah diinisialisasi; diperlukan satu kali
open() / close()Menampilkan atau menyembunyikan Ribbon; menutup juga membersihkan sorotan
reset()Menghapus istilah saat ini, jumlah hasil, dan sorotan
isOpen()Melaporkan apakah Ribbon terlihat
setStatus(message)Meneruskan pesan status melalui callback yang dikonfigurasi

Callback opsional onToggle(isOpen) memungkinkan host menyinkronkan tombol Pencariannya, dan onLayout memungkinkan host mengubah ukuran/menyesuaikan penampil ketika tinggi Ribbon berubah. Untuk urutan startup gabungan Penampil, Pencarian, dan Anotasi, lihat Panduan Cepat.

Pencarian dari JavaScript

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

Argumen kedua adalah pencocokan kata lengkap/tepat. Jumlah kecocokan tiba dalam callback: Search sendiri mengirim ke server dan tidak mengembalikan apa pun yang berguna, sehingga var n = objViewer.Search(keyword, false) selalu membaca undefined — dan halaman yang dibangun dengan cara itu melaporkan "tidak ada yang ditemukan" sementara penampil menyorot kecocokan. Setelah callback:

MetodeHasil
SearchMatchCount()Total kecocokan individu dalam dokumen.
SearchSummary(false)entri [pageNumber, matchCount] tanpa repainting.
SearchSummary(true)Ringkasan yang sama dan melukis sorotan halaman/thumbnail.
GotoSearchMatch(index)Menavigasi ke indeks kecocokan berbasis nol.

Rute middleware menggunakan search=<term> dan exact=true|false serta mengembalikan XML. Gunakan API widget daripada mengurai respons internal itu sendiri.

Periksa kemampuan pencarian

Respons inisialisasi melaporkan:

text
X-Doconut-Can-Search: 1

Setelah inisialisasi, objViewer.CanSearch() mengekspos keputusan format/sesi yang sama. Ia mengembalikan false ketika server mengirim 0; sebelum respons, atau dengan server lama yang menghilangkan header, ia default ke true.

Tiga gerbang independen tidak boleh disamakan:

GerbangPertanyaan
CanSearch() / response headerApakah penampil yang terresolusi memiliki jalur indeks/pencarian native?
AllowSearchApakah konfigurasi format ini meminta ekstraksi teks di mana saklar tersedia?
LicenseCapability.SearchApakah aplikasi diotorisasi untuk menjalankan pencarian dan menerima paket UI?

Sebuah format dapat secara teknis dapat dicari sementara lisensi saat ini menolak operasi tersebut.

Aktifkan ekstraksi per format

csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig
{
    AllowSearch = true,
    AllowCopy   = true   // opsional: memungkinkan pengguna menyeret sebuah wilayah dan menyalin teksnya
});

AllowSearch dan AllowCopy ada pada PdfConfig, WordConfig, ExcelConfig, dan PptConfig. Properti Office mendelegasikan ke PdfConfig yang bersarang. Keduanya default ke false.

Adaptor pencarian native standar ada untuk PDF, Word, Excel, PowerPoint, TXT, Visio, email, EPUB, dan MHT. XPS menggunakan jalur PDF-nya secara default. HTML dan Microsoft Project mendapat manfaat dari pengalihan PDF berbasis teks:

csharp
// DefaultRender = false → dikonversi menjadi PDF berbasis teks → dapat dicari
var token = await viewer.OpenDocumentAsync(path, new HtmlConfig { DefaultRender = false });

Untuk perender native, CanSearch() menjelaskan kemampuan penampil; itu tidak menjamin bahwa dokumen tertentu berisi teks yang dapat digunakan. PDF yang halamannya hanya berupa gambar hasil pemindaian masih dapat menghasilkan nol hasil native.

Perilaku Pencarian Normal

Server mencoba sumber pencarian dalam urutan berikut:

  1. Hasil dari penampil native format.
  2. Indeks pencarian .srh yang telah dibangun sebelumnya.
  3. Hasil error/kosong ketika tidak ada sumber pencarian.

Indeks .srh adalah artefak pencarian yang dipublikasikan bersamaan dengan gambar halaman ketika dokumen dilayani dari penyimpanan bersama, sehingga node yang belum pernah membuka dokumen masih dapat menjawab pencarian — lihat Penyebaran Terdistribusi.

CanSearch() dapat menjadi true untuk penampil yang dapat dicari bahkan ketika dokumen hasil pemindaian tertentu tidak memiliki lapisan teks dan oleh karena itu tidak menghasilkan kecocokan.

Lisensi dan perilaku UI

Lisensi Sementara/Demo yang aktif memberikan Pencarian selama periode aktifnya. Lisensi yang hilang dan file legacy TRIAL tidak memberikan kemampuan Pencarian. Tanpa Pencarian:

  • ReferenceCss dan ReferenceScripts menghilangkan paket pencarian.
  • Middleware menolak pencarian alih-alih mengembalikan hasil berlisensi.

Kendalikan visibilitas UI kustom dari IDoconutLicenseService.IsCapabilityGranted(LicenseCapability.Search) dan gunakan CanSearch() untuk keputusan format/sesi terpisah.

Pemecahan Masalah

GejalaPeriksa
Bar pencarian tidak adaKemampuan pencarian dan IncludeSearchCss/IncludeSearchScripts/IncludeSearchBar
CanSearch() salahPenampil format, jalur DefaultRender yang dipilih, dan header respons inisialisasi
Pencarian mengembalikan nol untuk PDF yang dipindaiDokumen tidak memiliki lapisan teks; gunakan sumber yang berisi teks atau proyeksi PDF yang mempertahankan teks
Pencarian berfungsi tetapi sorotan bergeserJalur rendering, resolusi, transformasi dokumen, dan kotak kata yang diekstrak

Apakah halaman ini membantu?