ViewerConfig

ViewerConfig (namespace Doconut) menjelaskan tampilan dan perilaku penampil browser. Itu tidak memengaruhi kualitas rendering dokumen; gunakan konfigurasi format untuk itu. Kelas C# dan plugin JavaScript legacy memiliki nilai 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 = "/",                 // "/" = handler DocImage.axd di root situs (Web.config)
    ResPath = "doconut-res/images", // folder images di bawah ResourcesPath, tanpa '/' di depan
    ShowHyperlinks = true
};
// Keluarkan dengan viewer.RenderViewer("viewerEl", token, config) - lihat referensi Viewer.

Menghasilkan ViewerConfig dengan RenderViewer

Viewer.RenderViewer(elementId, token, config) mengubah ViewerConfig menjadi skrip inisialisasi widget. Ia menulis enam properti di atas — BasePath, ResPath, ShowThumbs, AutoLoad, PageZoom, dan FitType — dan kemudian memanggil View(token). Properti lainnya tidak ditulis: untuk MaxZoom, ShowHyperlinks, pengaturan zoom, atau callback apa pun, inisialisasi widget sendiri dengan opsi JavaScript di bawah ini. Lihat Penampil untuk RenderViewer.

Pemetaan C# ke JavaScript

Jangan mengirim ViewerConfig yang diserialkan langsung ke docViewer(...). Sebagian besar kunci widget menggunakan camelCase, sementara tiga kunci path/fit yang sudah mapan menggunakan PascalCase.

Default JavaScript

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

Atur semua nilai penting perilaku alih-alih mengandalkan 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: '/',
    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.

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.

Opsi Pengulangan

Widget ini juga menerima retryOn409 dan pengaturan backoff‑nya (retryInitialDelayMs, retryBackoffFactor, retryMaxDelayMs, retryMaxAttempts, retryMaxTotalMs). Mereka melayani penyebaran yang halaman‑halamannya diproduksi di latar belakang. DocImage.axd merender setiap halaman selama permintaan, jadi biarkan retryOn409 dimatikan.

Daftar Periksa Jalur

• BasePath adalah '/' ketika handler DocImage.axd berada di akar situs — atribut path dari handler di Web.config menentukan ke mana ia menjawab. Dalam direktori virtual, gunakan nama direktori tanpa / di depan ('myapp', bukan '/myapp': penampil menambahkan garis miring, dan //myapp/... adalah permintaan ke host lain).
• DoconutOptions.ResourcesPath adalah tempat modul sumber daya menyajikan file tersemat (/doconut-res secara default).
• ResPath menargetkan subfolder images‑nya, juga tanpa / di depan ('doconut-res/images'). Menunjukkannya ke 'doconut-res' membuat semua ikon 404 sementara dokumen tetap dirender.
• Dalam MVC, routes.IgnoreRoute("doconut-res/{*pathInfo}") harus mengikuti ResourcesPath jika Anda mengubahnya.
• ExtractHyperlinks harus diaktifkan dalam konfigurasi format server sebelum showHyperlinks dapat menampilkan apa pun.