Tema Kustom

Gaya penampil agar cocok dengan aplikasi Anda

Penampil dilengkapi dengan tampilan netral berbasis Bootstrap yang disajikan dari sumber daya tersemat (viewer.css, serta stylesheet per-fitur seperti searchBar.css dan annotationBar.css). Penataan tema terjadi pada tiga tingkat — pilih tingkat paling dangkal yang memenuhi kebutuhan Anda.

Tingkat 1 — Konfigurasikan bingkai

Banyak “penataan tema” 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> biasa; 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); }

/* Kartu halaman widget */
.docPage { max-width: none; }

Halaman host mengontrol tata letak luar sepenuhnya — widget merender di dalam kotak apa pun yang Anda berikan #divDocViewer / #div_ctlDoc (pasangan kontainer standar dari Quick Start).

  • Jangan memuat Bootstrap dua kali. Jika aplikasi Anda sudah menyertakan Bootstrap, lewati IncludeBootstrapCss/IncludeBootstrap dan biarkan widget mewarisi milik Anda — hal ini saja membuat penampil tampak alami 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 lengkap, kendalikan widget dari UI Anda sendiri. Bilah alat semacam itu adalah markup host ditambah helper khusus aplikasi; itu bukan Ribbon SDK yang tersemat. Instansi docViewer yang dikembalikan oleh inisialisasi adalah permukaan API Anda, bersama dengan endpoint Anda sendiri — di sini aksi ViewerApi/Open dari Cara Kerja Penampil:

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:   '/',
        ResPath:    'doconut-res/images',
        onViewerReady: () => { /* aktifkan tombol Anda */ },
        onError: (msg) => console.error('DocViewer:', msg)
    });

    document.getElementById('btnOpen').addEventListener('click', async () => {
        const resp  = await fetch('/ViewerApi/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 Panduan Cepat untuk urutan integrasi lengkap.

Mode Gelap dan RTL

Widget tidak menyediakan tema gelap; penimpaan Tingkat 2 yang menargetkan kelas mode-gelap Anda (misalnya .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 memfork atau mengedit stylesheet yang tersemat: mereka disertakan dalam paket dan diganti pada setiap pembaruan. Penimpaan dalam stylesheet Anda sendiri tetap bertahan setelah peningkatan; penyuntingan viewer.css tidak.

Apakah halaman ini membantu?