נושאים מותאמים
התאם את המראה של הצופה לאפליקציה שלך
הצופה מגיע עם מראה נייטרלי מבוסס Bootstrap שמסופק מהמשאבים המוטמעים (viewer.css, וכן קבצי CSS לכל תכונה כמו searchBar.css ו-annotationBar.css). התאמה נעשית בשלושה רמות — בחרו את הרמה השטוחה ביותר שמביאה אתכם לשם.
רמה 1 — קביעת תצורת הכרום
הרבה מ'התאמה' היא בעצם קונפיגורציה:
ViewerConfig.ShowThumbs = false— ללא לוח תצוגה מקדימה.ViewerConfig.FitType = "height" | "width"— כיצד דפים ממלאים את תצוגת החלון.- חבילות סלקטיביות של
CssConfig/ScriptConfig— שמרו רק על הכרום שהמארח שלכם משתמש בו.
רמה 2 — דריסת ה‑CSS
Viewer.ReferenceCss() מפיק תגיות <link> פשוטות; כל מה שאתם טוענים לאחר הן מנצח את הקסקדה. הגדירו את הגודל והמסגרת של הצופה מקובץ ה‑CSS שלכם:
/* גיליון הסגנון שלך, נטען אחרי ReferenceCss() */
/* שני המכולות שבבעלותך */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }
/* כרטיסי דף וידג'ט */
.docPage { max-width: none; }דף המארח שולט במלואו בפריסת החיצונית — הווידג'ט מציג עצמו בתוך כל קופסה שאתם מספקים ל#divDocViewer / #div_ctlDoc (זוג המכולות הסטנדרטי מההתחלה המהירה).
שתי כללים מעשיים:
- אל תטעינו Bootstrap פעמיים. אם האפליקציה שלכם כבר כוללת Bootstrap, דלגו על
IncludeBootstrapCss/IncludeBootstrapותנו לווידג'ט לרשת את שלכם — זה לבדו גורם לצופה להיראות טבעי באפליקציה שלכם. - כלול רק את החבילות שבהן אתם משתמשים. כל דגל של
CssConfig/ScriptConfigהוא אופציונלי; פחות חבילות, פחות סגנונות להילחם בהם.
רמה 3 — בניית סרגל הכלים שלכם
לחוויית מותג מלאה, שלטו בווידג'ט דרך ממשק המשתמש שלכם. סרגל כלים כזה הוא סימון של המארח בתוספת עזר ייחודי לאפליקציה; הוא אינו ריבון 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: '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>חיפוש והערה שונים: רכיבי הריבון האופציונליים שלהם משולבים ב‑SDK (IncludeSearchBar, IncludeAnnotationBar) ויוצרים DOM משלהם. אתם יכולים להשתמש בהם יחד עם סרגל הכלים המותאם שלכם לצופה, או לדלג עליהם ולקרוא ישירות ל‑API של הווידג'ט. ראו את חבילת הצופה המלאה במדריך המהיר לקבלת סדר האינטגרציה המלא.
מצב כהה ו‑RTL
הווידג'ט אינו מספק ערכת נושא כהה; דריסת רמה 2 שמכוונת למחלקת המצב הכהה שלכם (למשל .dark #divDocViewer { … }) ברקעים ובקצוות מכסה את רוב הצרכים, מכיוון שתוכן העמוד עצמו מוצג כתמונות. עבור מארחי RTL, הצופה פועל בשמחה בתוך פריסת RTL — שמרו על כך שסרגל הכלים שלכם מודע ל‑RTL.
מה שלא לעשות
אל תבצעו פיצול או עריכה של קבצי ה‑CSS המוטמעים: הם נשלחים כחלק מהחבילה ומוחלפים בכל עדכון. דריסות בקובץ ה‑CSS שלכם נשארות אחרי שדרוגים; עריכות לviewer.css אינן נשמרות.
האם דף זה היה מועיל?