ธีมแบบกำหนดเอง
จัดรูปแบบตัวดูให้ตรงกับแอปของคุณ
ตัวดูมาพร้อมกับลุคที่เป็นกลางและอิง Bootstrap ซึ่งให้บริการจากทรัพยากรที่ฝังอยู่ (viewer.css, รวมถึงสไตล์ชีตตามฟีเจอร์เช่น searchBar.css และ annotationBar.css). การทำธีมเกิดขึ้นในสามระดับ — เลือกระดับที่ตื้นที่สุดที่ทำให้คุณได้ผลลัพธ์ที่ต้องการ.
ระดับ 1 — กำหนดค่าโครม
การ "ทำธีม" จำนวนมากจริง ๆ แล้วเป็นการกำหนดค่า:
ViewerConfig.ShowThumbs = false— ไม่มีแผงรูปย่อ.ViewerConfig.FitType = "height" | "width"— วิธีที่หน้าเว็บเติมเต็มมุมมอง.- แพ็คเกจเลือกสรร
CssConfig/ScriptConfig— เก็บเฉพาะโครมที่โฮสต์ของคุณใช้.
ระดับ 2 — แทนที่ CSS
Viewer.ReferenceCss() ส่งออกแท็ก <link> ธรรมดา; สิ่งใดที่คุณโหลด หลังจาก พวกมันจะชนะการทำงานของ cascade. ปรับขนาดและกรอบของตัวดูจากสไตล์ชีตของคุณเอง:
/* สไตล์ชีตของคุณ, โหลดหลังจาก ReferenceCss() */
/* คอนเทนเนอร์สองตัวของคุณ */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }
/* การ์ดหน้าวิดเจ็ต */
.docPage { max-width: none; }หน้าโฮสต์ควบคุมการจัดวางภายนอกอย่างสมบูรณ์ — วิดเจ็ตจะเรนเดอร์ภายในกล่องใดก็ได้ที่คุณให้ #divDocViewer / #div_ctlDoc (คู่คอนเทนเนอร์มาตรฐานจาก Quick Start).
สองกฎปฏิบัติที่เป็นประโยชน์:
- ห้ามโหลด Bootstrap ซ้ำ หากแอปของคุณมี Bootstrap อยู่แล้ว, ข้าม
IncludeBootstrapCss/IncludeBootstrapและให้วิดเจ็ตสืบทอดของคุณ — สิ่งนี้เพียงอย่างเดียวทำให้ตัวดูดูเป็นเนทีฟกับแอปของคุณ. - รวมเฉพาะแพ็คเกจที่คุณใช้ ทุกแฟล็ก
CssConfig/ScriptConfigเป็นแบบเลือกใช้; แพ็คเกจน้อยลง, สไตล์น้อยลงที่ต้องต่อสู้.
ระดับ 3 — สร้างแถบเครื่องมือของคุณเอง
เพื่อประสบการณ์ที่มีแบรนด์เต็มรูปแบบ, ควบคุมวิดเจ็ตจาก UI ของคุณเอง. แถบเครื่องมือเช่นนั้นคือมาร์คอัปของโฮสต์พร้อมกับตัวช่วยเฉพาะแอป; ไม่ใช่ Ribbon ของ SDK ที่ฝังอยู่. อินสแตนซ์ docViewer ที่ส่งกลับจากการเริ่มต้นคือพื้นผิว API ของคุณ, พร้อมกับเอ็นด์พอยต์ของคุณเอง:
<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: '/',
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>Search และ Annotation แตกต่างกัน: ส่วนประกอบ Ribbon ทางเลือกของพวกเขาถูกฝังใน SDK (IncludeSearchBar, IncludeAnnotationBar) และสร้าง DOM ของตนเอง. คุณสามารถใช้พวกมันร่วมกับแถบเครื่องมือ Viewer ที่กำหนดเองของคุณหรือข้ามพวกมันและเรียก API ของวิดเจ็ตพื้นฐานด้วยตนเอง. ดูที่ แพ็กเกจ Viewer ครบถ้วนใน Quick Start สำหรับลำดับการบูรณาการที่สมบูรณ์.
โหมดมืดและ RTL
วิดเจ็ตไม่มีธีมมืด; การแทนที่ระดับ 2 ที่มุ่งเป้าไปที่คลาสโหมดมืดของคุณ (เช่น .dark #divDocViewer { … }) บนพื้นหลังและขอบจะครอบคลุมความต้องการส่วนใหญ่, เนื่องจากเนื้อหาหน้าตัวเองถูกเรนเดอร์เป็นภาพ. สำหรับโฮสต์ RTL, ตัวดูทำงานได้อย่างราบรื่นภายในเลเอาต์ RTL — ให้แถบเครื่องมือของคุณรับรู้ RTL.
สิ่งที่ไม่ควรทำ
ห้าม fork หรือแก้ไขสไตล์ชีตที่ฝังอยู่: พวกมันมาพร้อมกับแพ็กจและจะถูกแทนที่ทุกครั้งที่อัปเดต. การแทนที่ในสไตล์ชีตของคุณจะคงอยู่หลังการอัปเกรด; การแก้ไข viewer.css จะไม่ทำเช่นนั้น.
หน้านี้เป็นประโยชน์หรือไม่?