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

Properti C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "doconut",           // tidak ada '/' di depan: penampil akan menambahkannya ("/doconut" akan menjadi //doconut, host lain)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

Pemetaaan C# ke JavaScript

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

JavaScript Bawaan

Widget memiliki nilai bawaan 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 bawaan:

<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>

Panggilan Balik

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

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.

Coba ulang saat halaman terdistribusi masih merender

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

Biarkan dinonaktifkan untuk penampil normal. Mengaktifkannya tidak dapat membuat render sinkron yang tidak didukung menjadi asinkron.

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).
• DoconutOptions.ResourcesPath adalah rute sumber daya yang disematkan.
• ResPath biasanya menargetkan subfolder images-nya, juga tanpa awalan / ('doconut-res/images').
• ExtractHyperlinks harus diaktifkan dalam konfigurasi format server sebelum showHyperlinks dapat menampilkan apa pun.