נושאים מותאמים

התאם את המראה של הצופה ליישום שלך

הצופה מגיע עם מראה נייטרלי המבוסס על Bootstrap, המסופק מהמשאבים המוטמעים (viewer.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 שלכם, יחד עם הקצוות שלכם:

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:   '/',
        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 משלהם. ניתן להשתמש בהם יחד עם סרגל הכלים המותאם שלכם או לדלג עליהם ולקרוא ישירות ל‑APIs של הווידג'ט. ראו את חבילת הצופה המלאה במדריך ההתחלה המהירה לקבלת סדר האינטגרציה המלא.

מצב כהה ו‑RTL

הווידג'ט אינו כולל ערכת נושא כהה; דריסה ברמה 2 המכוונת למחלקת המצב הכהה שלכם (למשל .dark #divDocViewer { … }) ברקעים ובקצוות מכסה את רוב הצרכים, מכיוון שהתוכן של הדף עצמו מוצג כתמונות. עבור מארחים עם RTL, הצופה פועל ללא בעיה בתוך פריסת RTL — שמרו על סרגל הכלים שלכם מודע ל‑RTL.

מה שלא לעשות

אל תבצעו פיצול או עריכה של גיליונות הסגנון המוטמעים: הם מגיעים כחלק מהחבילה ומוחלפים בכל עדכון. דריסות בגיליון הסגנון שלכם נשארות לאחר שדרוגים; עריכות לviewer.css אינן נשמרות.

האם דף זה היה מועיל?