ViewerConfig

ViewerConfig (namespace Doconut) menjelaskan tampilan dan perilaku penampil browser. Ini tidak memengaruhi kualitas rendering dokumen; gunakan konfigurasi format untuk itu. Kelas C# dan widget JavaScript yang telah lama ada memiliki default yang berbeda, jadi petakan nilai secara eksplisit.

Dua perubahan sisi klien dalam rilis ini gagal secara diam‑diam. Fungsi handler diteruskan sebagai opsi — widget tidak lagi menurunkan nama fungsi global dari id kontainer — dan ResPath harus mengarah ke prefiks sumber daya bukan ke akar aplikasi. Kedua hal tersebut membuat server berfungsi sempurna dan tidak melaporkan apa pun di konsol browser. Jika Anda membawa halaman dari perpustakaan sebelumnya, baca Callback dan Daftar periksa jalur sebelum hal lain.

Properti C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "/doconut",
    ResPath = "/doconut-res/images",
    ShowHyperlinks = true
};

Pemetaan C# ke JavaScript

Default JavaScript

Widget memiliki default yang lebih lama dan berbeda dari kelas C#. Nilai‑nilai berikut diambil dari implementasi docViewer.js saat ini.

Tetapkan semua nilai yang penting secara perilaku alih‑alih mengandalkan salah satu set default. Contoh penggunaan:

<div id="divDocViewer"><div id="div_ctlDoc"></div></div>

<script>
const objViewer = $('#div_ctlDoc').docViewer({
    showThumbs: true,
    autoLoad: false,
    autoFocus: true,
    autoPageFocus: true,
    pageZoom: 100,
    zoomStep: 10,
    maxZoom: 300,
    FitType: 'width',
    cacheEnabled: false,
    largeDoc: false,
    showHyperlinks: true,
    fixedZoom: true,
    fixedZoomPercent: 100,
    fixedZoomPercentMobile: 75,
    BasePath: '/doconut',
    ResPath: '/doconut-res/images',
    onViewerReady: function () {},
    onError: function (message) { console.error('DocViewer:', message); }
});
</script>

Callback

Jaga callback tetap cepat; kirim telemetry secara asinkron dan jangan memblokir rendering halaman.

Setiap satu dari ini adalah opsi pada objek init. Penampil sebelumnya mencari fungsi global yang namanya diturunkan dari id kontainer — sebuah halaman dengan <div id="div_ctlDoc"> hanya perlu mendeklarasikan function ctlDoc_OnViewerReady(). Pencarian itu sudah tidak ada. Lewatkan fungsi secara eksplisit:

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... your existing options ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // was found by name
    onViewerReady:    ctlDoc_OnViewerReady,     // was found by name
    onCopy:           ctlDoc_Copy,              // was ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // was ctlDoc_AutoLoadStatus(page)
});

Pencarian lama dibungkus dalam catch kosong, sehingga tidak ada yang pernah dilaporkan. Pada rilis ini fungsi‑fungsi tidak pernah dijalankan: gejala umum adalah spinner sibuk yang tidak pernah berhenti, karena handler yang menyembunyikannya adalah onViewerReady. Dokumen di belakangnya dirender dengan benar.

Tidak ada callback klik tautan — penanganan hyperlink sudah terintegrasi dan dikendalikan oleh showHyperlinks.

Grup metode publik

File JavaScript juga berisi pembantu internal. Perlakukan hanya metode yang digunakan oleh UI referensi dan didokumentasikan di sini atau dalam panduan fitur sebagai titik integrasi yang stabil.

Retry saat halaman terdistribusi masih dirender

retryOn409 mempertahankan nama historisnya. Ini untuk produksi halaman asinkron dan mencoba kembali respons kesiapan 202 Accepted serta sinyal 409 Conflict yang lebih lama. Ketika diaktifkan, widget melakukan polling dengan default JavaScript berikut:

Tetap nonaktifkan untuk penampil node tunggal normal. Mengaktifkannya tidak dapat membuat render sinkron yang tidak didukung menjadi asinkron.

Aktifkan ketika halaman disajikan dari penyimpanan bersama dengan FirstPagePriority, di mana halaman berikutnya sah menjawab 202 Accepted hingga ditulis. Klien yang tidak melakukan retry akan menampilkan ubin rusak untuk halaman yang masih dirender — lihat Penyebaran Terdistribusi.

Daftar periksa jalur

• DoconutOptions.MiddlewarePath harus menggambarkan cabang yang sebenarnya Anda petakan.
• BasePath harus menargetkan cabang tersebut. Aplikasi referensi mempertahankan bentuk permintaan historis DocImage.axd pada cabang MapWhen dan oleh karena itu mengatur BasePath: '/'.
• DoconutOptions.ResourcesPath adalah rute sumber daya tersemat.
• ResPath biasanya menargetkan subfolder /images‑nya — 'doconut-res/images' dengan prefiks default. ResPath kosong benar pada perpustakaan sebelumnya, di mana sumber daya berasal dari akar aplikasi; ini tidak benar di sini, dan akan gagal tanpa error.
• ExtractHyperlinks harus diaktifkan dalam konfigurasi format server sebelum showHyperlinks dapat menampilkan apa pun.