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 nilai default yang berbeda, jadi petakan nilai secara eksplisit.

Dua perubahan sisi klien dalam rilis ini gagal secara diam-diam. Fungsi penangan diteruskan sebagai opsi — widget tidak lagi mengambil nama fungsi global dari id kontainer — dan ResPath harus mengarah ke awalan sumber daya bukan ke akar aplikasi. Kedua hal tersebut membuat server tetap berfungsi dengan baik 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",           // tanpa '/' di depan: penampil menambahkannya ("/doconut" akan menjadi //doconut, host lain)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

Pemetaaan C# ke JavaScript

Jangan lewati ViewerConfig yang diserialisasi secara langsung ke docViewer(...). Kebanyakan kunci widget menggunakan camelCase, sementara tiga kunci jalur/fit yang sudah ada menggunakan PascalCase.

Default JavaScript

Widget memiliki nilai default lama yang berbeda dari kelas C#. Nilai berikut berasal dari implementasi docViewer.js saat ini.

Atur semua nilai penting perilaku alih-alih bergantung pada salah satu set default:

<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 telemetri secara asinkron dan jangan memblokir rendering halaman.

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

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... opsi Anda yang ada ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // ditemukan berdasarkan nama
    onViewerReady:    ctlDoc_OnViewerReady,     // ditemukan berdasarkan nama
    onCopy:           ctlDoc_Copy,              // sebelumnya ctlDoc_Copy(teks)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // sebelumnya ctlDoc_AutoLoadStatus(halaman)
});

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 penangan yang menyembunyikannya adalah onViewerReady. Dokumen di belakangnya dirender dengan benar.

Tidak ada callback klik tautan — penanganan hyperlink sudah built-in dan dikendalikan oleh showHyperlinks.

Grup metode publik

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

Coba ulang saat halaman terdistribusi masih sedang merender

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

Biarkan nonaktif 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 secara sah menjawab 202 Accepted hingga ditulis. Klien yang tidak mencoba ulang akan menampilkan ubin rusak untuk halaman yang masih merender — lihat Penyebaran Terdistribusi.

Daftar periksa jalur

• DoconutOptions.MiddlewarePath harus menggambarkan cabang yang sebenarnya Anda petakan.
• BasePath harus menargetkan cabang itu, ditulis tanpa awalan / ('doconut', bukan '/doconut': penampil menambahkan garis miring, dan //doconut/... adalah permintaan ke host lain). Aplikasi referensi mempertahankan bentuk permintaan historis DocImage.axd pada cabang MapWhen dan oleh karena itu mengatur BasePath: '/'.
• DoconutOptions.ResourcesPath adalah rute sumber daya yang disematkan.
• ResPath biasanya menargetkan subfolder images‑nya, tanpa awalan / — 'doconut-res/images' dengan awalan bawaan. ResPath kosong memang benar pada pustaka sebelumnya, di mana sumber daya berasal dari akar aplikasi; itu tidak benar di sini, dan akan gagal tanpa error.
• ExtractHyperlinks harus diaktifkan dalam konfigurasi format server sebelum showHyperlinks dapat menampilkan apa pun.