ธีมที่กำหนดเอง

ปรับสไตล์ตัวดูให้ตรงกับแอปของคุณ

ตัวดูมาพร้อมกับรูปลักษณ์ที่เป็นกลางและอิง Bootstrap ซึ่งให้บริการจากทรัพยากรที่ฝังอยู่ (viewer.css, รวมถึงสไตล์ชีตตามฟีเจอร์เช่น searchBar.css และ annotationBar.css). การปรับธีมเกิดขึ้นในสามระดับ — เลือกระดับที่ตื้นที่สุดที่ทำให้คุณได้ผลลัพธ์ที่ต้องการ.

ระดับ 1 — กำหนดค่าครอม

ส่วนใหญ่ของ “การธีม” จริง ๆ แล้วเป็นการกำหนดค่า:

  • ViewerConfig.ShowThumbs = false — ไม่มีแผงภาพย่อ.
  • ViewerConfig.FitType = "height" | "width" — วิธีที่หน้าเต็มหน้าต่างมุมมอง.
  • Selective CssConfig/ScriptConfig bundles — เก็บเฉพาะครอมที่โฮสต์ของคุณใช้.

ระดับ 2 — แทนที่ CSS

Viewer.ReferenceCss() สร้างแท็ก <link> ธรรมดา; สิ่งใดที่คุณโหลด หลัง พวกมันจะชนะการไหลของ cascade. กำหนดขนาดและกรอบของตัวดูจากสไตล์ชีตของคุณเอง:

css
/* สไตล์ชีตของคุณ, โหลดหลังจาก ReferenceCss() */

/* คอนเทนเนอร์สองตัวที่คุณเป็นเจ้าของ */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }

/* การ์ดหน้า Widget */
.docPage { max-width: none; }

หน้าโฮสต์ควบคุมการจัดวางภายนอกอย่างสมบูรณ์ — วิดเจ็ตเรนเดอร์ภายในกล่องใดก็ได้ที่คุณให้ #divDocViewer / #div_ctlDoc (คู่คอนเทนเนอร์มาตรฐานจาก Quick Start).

สองกฎปฏิบัติที่เป็นประโยชน์:

  • อย่าโหลด Bootstrap ซ้ำ. หากแอปของคุณมี Bootstrap อยู่แล้ว, ข้าม IncludeBootstrapCss/IncludeBootstrap และให้วิดเจ็ตสืบทอดของคุณ — สิ่งนี้เพียงอย่างเดียวทำให้ตัวดูดูเป็นเนทีฟกับแอปของคุณ.
  • รวมเฉพาะแพคเกจที่คุณใช้. ทุกแฟล็ก CssConfig/ScriptConfig เป็นแบบ opt‑in; แพคเกจน้อยลง, สไตล์น้อยลงที่จะต้องต่อสู้.

ระดับ 3 — สร้างแถบเครื่องมือของคุณเอง

อินสแตนซ์ docViewer ที่ส่งกลับจากการเริ่มต้นคือพื้นผิว API ของคุณ, พร้อมกับเอ็นด์พอยต์ของคุณเอง:

html
<div id="toolbar">
    <button id="btnOpen">Open</button>
    <button id="btnPrev">‹</button>
    <button id="btnNext">›</button>
    <!-- ระบบออกแบบของคุณ, ไอคอนของคุณ -->
</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: () => { /* เปิดใช้งานปุ่มของคุณ */ },
        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>

การค้นหาและการอธิบายเป็นสิ่งที่แตกต่าง: ส่วนประกอบ Ribbon ทางเลือกของพวกเขาถูกฝังใน SDK (IncludeSearchBar, IncludeAnnotationBar) และสร้าง DOM ของตนเอง. คุณสามารถใช้พวกมันร่วมกับแถบเครื่องมือ Viewer ที่กำหนดเองของคุณหรือข้ามพวกมันและเรียก API ของวิดเจ็ตพื้นฐานด้วยตนเอง. ดูที่ แพคเกจ Viewer ที่สมบูรณ์ใน Quick Start สำหรับลำดับการรวมที่สมบูรณ์.

โหมดมืดและ RTL

วิดเจ็ตไม่มีธีมมืด; การแทนที่ระดับ 2 ที่มุ่งเป้าไปที่คลาสโหมดมืดของคุณ (เช่น .dark #divDocViewer { … }) บนพื้นหลังและขอบจะครอบคลุมความต้องการส่วนใหญ่, เนื่องจากเนื้อหาหน้าต่างเองถูกเรนเดอร์เป็นภาพ. สำหรับโฮสต์ที่ใช้ RTL, ตัวดูทำงานได้อย่างราบรื่นภายในเลย์เอาต์ RTL — ให้แถบเครื่องมือของคุณรองรับ RTL.

สิ่งที่ไม่ควรทำ

ห้าม fork หรือแก้ไขสไตล์ชีตที่ฝังอยู่: พวกมันมาพร้อมกับแพคเกจและจะถูกแทนที่ทุกครั้งที่อัปเดต. การแทนที่ในสไตล์ชีตของคุณเองจะคงอยู่หลังการอัปเกรด; การแก้ไข viewer.css จะไม่ทำงาน.

หน้านี้เป็นประโยชน์หรือไม่?