ערכות נושא מותאמות
התאם את המראה של הצופה כך שיתאים לאפליקציה שלך
הצופה מגיע עם מראה נייטרלי, מבוסס 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 (זוג המכולות הסטנדרטי מ‑Quick Start).
שתי כללים מעשיים:
- אל תטעינו Bootstrap פעמיים. אם האפליקציה שלכם כבר כוללת Bootstrap, דלגו על
IncludeBootstrapCss/IncludeBootstrapותנו לווידג'ט לרשת את שלכם — זה לבדו גורם לצופה להיראות טבעי באפליקציה שלכם. - כלול רק את החבילות שבהן אתם משתמשים. כל דגל
CssConfig/ScriptConfigהוא אופציונלי; פחות חבילות, פחות סגנונות להתמודד איתם.
רמה 3 — בניית סרגל הכלים שלכם
לחוויית מותג מלאה, שלטו בווידג'ט דרך הממשק שלכם. סרגל כלים כזה הוא סימון של המארח בתוספת עוזר ייחודי לאפליקציה; הוא אינו ריבון SDK מוטמע. המופע docViewer שמוחזר באתחול הוא ממשק ה‑API שלכם, יחד עם נקודות הקצה שלכם — כאן הפעולה ViewerApi/Open מ‑איך הצופה עובד:
<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('/ViewerApi/Open?fileName=Sample.pdf', { method: 'POST' });
const token = await resp.text();
objViewer.View(token);
});
</script>חיפוש והערה הם שונים: רכיבי הריבון האופציונליים שלהם מוטמעים ב‑SDK (IncludeSearchBar, IncludeAnnotationBar) ויוצרים DOM משלהם. ניתן להשתמש בהם יחד עם סרגל הכלים המותאם של הצופה שלכם או לדלג עליהם ולקרוא ישירות ל‑APIs של הווידג'ט. ראו את התחלה מהירה לקבלת סדר האינטגרציה המלא.
מצב חשוך ו‑RTL
הווידג'ט אינו כולל ערכת נושא חשוכה; דריסת רמה 2 המכוונת למחלקת המצב החשוך שלכם (למשל .dark #divDocViewer { … }) ברקעים ובקצוות מכסה את רוב הצרכים, מכיוון שתוכן העמוד עצמו מוצג כתמונות. עבור מארחי RTL, הצופה פועל ללא בעיה בתוך פריסת RTL — שמרו על סרגל הכלים שלכם מודע ל‑RTL.
מה שלא לעשות
אל תבצעו fork או עריכה של קבצי ה‑CSS המוטמעים: הם מגיעים בתוך החבילה ומוחלפים בכל עדכון. דריסות בקובץ ה‑CSS שלכם נשארות אחרי שדרוגים; עריכות ל‑viewer.css אינן נשמרות.
האם דף זה היה מועיל?