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

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

הצופה מגיע עם מראה ניטרלי המבוסס על Bootstrap ומסופק מהמשאבים המוטמעים (viewer.css, בנוסף לקבצי CSS לכל תכונה כמו searchBar.css ו‑annotationBar.css). התאמה נעשית בשלושה רמות — בחרו את הרמה השטוחה ביותר שמביאה אתכם לשם.

רמה 1 — הגדרת הכרום

  • ViewerConfig.ShowThumbs = false — ללא לוח תצוגה מקדימה.
  • ViewerConfig.FitType = "height" | "width" — איך דפים ממלאים את חלון התצוגה.
  • חבילות נבחרות של CssConfig/ScriptConfig — שמרו רק על הכרום שהמארח שלכם משתמש בו.

רמה 2 — דריסת ה‑CSS

Viewer.ReferenceCss() מפיק תגיות <link> פשוטות; כל מה שאתה טוען לאחר הן מנצח את סדר העדיפויות. קבע את הגודל והמסגרת של הצופה מקובץ ה‑CSS שלך:

css
/* גיליון הסגנון שלך, נטען אחרי ReferenceCss() */

/* שני המכולות שלך */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }

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

מצב כהה ו‑RTL

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

מה שלא לעשות

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

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