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:

css
/* 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/IncludeBootstrap dan biarkan widget mewarisi milik Anda — hal ini saja membuat penampil tampak asli pada aplikasi Anda.
  • Sertakan hanya bundel yang Anda gunakan. Setiap flag CssConfig/ScriptConfig bersifat 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:

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