Özel Temalar

Görüntüleyiciyi uygulamanıza uyacak şekilde stil verin

Görüntüleyici, gömülü kaynaklardan (viewer.css, ayrıca searchBar.css ve annotationBar.css gibi özellik bazlı stil sayfaları) sunulan nötr, Bootstrap tabanlı bir görünüme sahiptir. Tema oluşturma üç seviyede gerçekleşir — sizi oraya götüren en sığ seviyeyi seçin.

Seviye 1 — Çerçeveyi yapılandırın

  • ViewerConfig.ShowThumbs = false — küçük resim paneli yok.
  • ViewerConfig.FitType = "height" | "width" — sayfaların görünüm alanını nasıl doldurduğu.
  • Seçici CssConfig/ScriptConfig paketleri — yalnızca ana bilgisayarınızın kullandığı çerçeveyi tutun.

Seviye 2 — CSS'i geçersiz kılın

Viewer.ReferenceCss() düz <link> etiketleri üretir; onlardan sonra yüklediğiniz her şey kademeyi kazanır. Görüntüleyicinin boyutunu ve çerçevesini kendi stil sayfanızdan ayarlayın:

css
/* Stil sayfanız, ReferenceCss() sonrasında yüklendi */

/* Sahip olduğunuz iki konteyner */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }

/* Widget sayfa kartları */
.docPage { max-width: none; }

Ana sayfa dış düzeni tamamen kontrol eder — widget, #divDocViewer / #div_ctlDoc (Hızlı Başlangıç'tan standart konteyner çifti) verdiğiniz herhangi bir kutunun içinde render eder.

İki pratik kural:

  • Bootstrap'ı iki kez yüklemeyin. Uygulamanız zaten Bootstrap içeriyorsa, IncludeBootstrapCss/IncludeBootstrap atlayın ve widget'ın sizinkini devralmasına izin verin — bu tek başına görüntüleyicinin uygulamanıza doğal görünmesini sağlar.
  • Sadece kullandığınız paketleri ekleyin. Her CssConfig/ScriptConfig bayrağı isteğe bağlıdır; daha az paket, mücadele edecek daha az stil.

Seviye 3 — Kendi araç çubuğunuzu oluşturun

Tamamen markalı bir deneyim için, widget'ı kendi UI'nizden yönetin. Böyle bir araç çubuğu, ana bilgisayar işaretlemesi artı uygulamaya özgü bir yardımcıdır; gömülü bir SDK Şeridi değildir. Başlatma tarafından döndürülen docViewer örneği, kendi uç noktalarınızla birlikte API yüzeyinizdir — burada Görüntüleyicinin Nasıl Çalıştığı içindeki ViewerApi/Open eylemi:

html
<div id="toolbar">
    <button id="btnOpen">Open</button>
    <button id="btnPrev">‹</button>
    <button id="btnNext">›</button>
    <!-- tasarım sisteminiz, ikonlarınız -->
</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: () => { /* butonlarınızı etkinleştir */ },
        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>

Arama ve Açıklama farklıdır: isteğe bağlı Şerit bileşenleri SDK'ya (IncludeSearchBar, IncludeAnnotationBar) gömülüdür ve kendi DOM'larını oluşturur. Bunları kendi özel Görüntüleyici araç çubuğunuzla birlikte kullanabilir veya atlayıp temel widget API'lerini kendiniz çağırabilirsiniz. Tam entegrasyon sırası için Hızlı Başlangıç sayfasına bakın.

Karanlık mod ve RTL

Widget karanlık bir tema sunmaz; arka plan ve kenarlıklarda (ör. .dark #divDocViewer { … }) karanlık-mod sınıfınızı hedefleyen Seviye 2 geçersiz kılma, çoğu ihtiyacı karşılar, çünkü sayfa içeriği kendisi görüntü olarak render edilir. RTL ana bilgisayarları için, görüntüleyici RTL bir düzen içinde sorunsuz çalışır — kendi araç çubuğunuzun RTL farkında olmasını sağlayın.

Yapılmaması Gerekenler

Gömülü stil sayfalarını çatallamayın veya düzenlemeyin: paket içinde gelirler ve her güncellemede yerine yenileri konur. Kendi stil sayfanızdaki geçersiz kılmalar yükseltmelerde kalır; viewer.css üzerindeki düzenlemeler ise kalmaz.

Bu sayfa yardımcı oldu mu?