Tema Kustom
Gaya penampil agar cocok dengan aplikasi Anda
Penampil dilengkapi dengan tampilan netral berbasis Bootstrap yang disajikan dari sumber daya tersemat (viewer.css, plus stylesheet per-fitur seperti searchBar.css dan annotationBar.css). Penataan tema terjadi pada tiga tingkat — pilih tingkat paling dangkal yang mencapainya.
Tingkat 1 — Konfigurasikan bingkai
Banyak “theming” sebenarnya hanyalah konfigurasi:
ViewerConfig.ShowThumbs = false— tanpa panel thumbnail.ViewerConfig.FitType = "height" | "width"— cara halaman mengisi viewport.- Bundel selektif
CssConfig/ScriptConfig— pertahankan hanya bingkai yang digunakan host Anda.
Tingkat 2 — Timpa CSS
Viewer.ReferenceCss() menghasilkan tag <link> polos; apa pun yang Anda muat setelah mereka akan menang dalam kaskade. Atur ukuran dan bingkai penampil dari stylesheet Anda sendiri:
/* Lembar gaya Anda, dimuat setelah ReferenceCss() */
/* Dua kontainer yang Anda miliki */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }
/* Widget kartu halaman */
.docPage { max-width: none; }Halaman host mengendalikan tata letak luar sepenuhnya — widget merender di dalam kotak apa pun yang Anda berikan #divDocViewer / #div_ctlDoc (pasangan kontainer standar dari Quick Start).
Dua aturan praktis:
- Jangan muat ganda Bootstrap. Jika aplikasi Anda sudah menyertakan Bootstrap, lewati
IncludeBootstrapCss/IncludeBootstrapdan biarkan widget mewarisi milik Anda — hal ini saja membuat penampil tampak asli pada aplikasi Anda. - Sertakan hanya bundel yang Anda gunakan. Setiap flag
CssConfig/ScriptConfigbersifat opsional; lebih sedikit bundel, lebih sedikit gaya yang harus dihadapi.
Tingkat 3 — Bangun bilah alat Anda sendiri
Untuk pengalaman bermerk penuh, kendalikan widget dari UI Anda sendiri. Bilah alat semacam itu adalah markup host ditambah pembantu khusus aplikasi; itu bukan Ribbon SDK yang tersemat. Instansi docViewer yang dikembalikan oleh inisialisasi adalah permukaan API Anda, bersama dengan endpoint Anda sendiri:
<div id="toolbar">
<button id="btnOpen">Open</button>
<button id="btnPrev">‹</button>
<button id="btnNext">›</button>
<!-- sistem desain Anda, ikon Anda -->
</div>
<div id="divDocViewer"><div id="div_ctlDoc"></div></div>
<script>
const objViewer = $('#div_ctlDoc').docViewer({
showThumbs: true,
autoLoad: false,
BasePath: 'doconut',
ResPath: 'doconut-res/images',
onViewerReady: () => { /* aktifkan tombol Anda */ },
onError: (msg) => console.error('DocViewer:', msg)
});
document.getElementById('btnOpen').addEventListener('click', async () => {
const resp = await fetch('/api/open?fileName=Sample.pdf', { method: 'POST' });
const token = await resp.text();
objViewer.View(token);
});
</script>Pencarian dan Anotasi berbeda: komponen Ribbon opsional mereka tersemat dalam SDK (IncludeSearchBar, IncludeAnnotationBar) dan menghasilkan DOM mereka sendiri. Anda dapat menggunakannya bersama dengan bilah alat Viewer khusus Anda atau melewatkannya dan memanggil API widget yang mendasarinya sendiri. Lihat paket Viewer lengkap di Quick Start untuk urutan integrasi lengkap.
Mode Gelap dan RTL
Widget tidak menyertakan tema gelap; penimpaan Tingkat 2 yang menargetkan kelas mode-gelap Anda (mis. .dark #divDocViewer { … }) pada latar belakang dan batas memenuhi sebagian besar kebutuhan, karena konten halaman itu sendiri dirender sebagai gambar. Untuk host RTL, penampil berfungsi dengan baik di dalam tata letak RTL — pastikan bilah alat Anda menyadari RTL.
Apa yang Tidak Boleh Dilakukan
Jangan mem-fork atau mengedit stylesheet yang tersemat: mereka disertakan dalam paket dan diganti pada setiap pembaruan. Penimpaan dalam stylesheet Anda sendiri bertahan setelah peningkatan; penyuntingan pada viewer.css tidak.
Apakah halaman ini membantu?