ViewerConfig

ViewerConfig (namespace Doconut) מתאר את המראה וההתנהגות של מציג הדפדפן. הוא אינו משפיע על איכות רינדור המסמך; השתמשו בתצורת פורמט עבור זאת. למחלקת C# והווידג'ט הוותיק של JavaScript יש ערכי ברירת מחדל שונים, ולכן יש למפות ערכים במפורש.

שתי שינויים בצד הלקוח במהדורה זו נכשלות בשקט. פונקציות מטפל מועברות כאופציות — הווידג'ט כבר לא יוצר שמות פונקציות גלובליים ממזהה המכולה — ו‑ResPath חייב להצביע על קידומת המשאבים במקום על שורש היישום. שני השינויים משאירים את השרת פועל בצורה מושלמת ולא מדווחים דבר בקונסול הדפדפן. אם אתם מעבירים דף מהספרייה הקודמת, קראו את Callbacks ו‑Path checklist לפני כל דבר אחר.

מאפייני C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "doconut",           // בלי סלאש מוביל '/': המציג מוסיף אותו ("/doconut" היה הופך ל‑//doconut, מארח אחר)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

מיפוי מ‑C# ל‑JavaScript

אל תעבירו ViewerConfig שמסודר ישירות ל‑docViewer(...). רוב מפתחות הווידג'ט הם camelCase, בעוד שלושה מפתחות נתיב/התאמה מבוססי PascalCase.

ברירות מחדל של JavaScript

הווידג'ט מכיל ברירות מחדל ישנות השונות מהמחלקה ב‑C#. הערכים הבאים מגיעים מיישום ה‑docViewer.js הנוכחי.

הגדר את כל הערכים החשובים להתנהגות במקום להסתמך על אחד משני סטים של ברירות מחדל:

<div id="divDocViewer"><div id="div_ctlDoc"></div></div>

<script>
const objViewer = $('#div_ctlDoc').docViewer({
    showThumbs: true,
    autoLoad: false,
    autoFocus: true,
    autoPageFocus: true,
    pageZoom: 100,
    zoomStep: 10,
    maxZoom: 300,
    FitType: 'width',
    cacheEnabled: false,
    largeDoc: false,
    showHyperlinks: true,
    fixedZoom: true,
    fixedZoomPercent: 100,
    fixedZoomPercentMobile: 75,
    BasePath: 'doconut',
    ResPath: 'doconut-res/images',
    onViewerReady: function () {},
    onError: function (message) { console.error('DocViewer:', message); }
});
</script>

קריאות חזרה

שמור על קריאות החזרה מהירות; שלח טלמטריה באופן אסינכרוני ואל תחסום את רינדור העמוד.

כל אחת מהן היא אפשרות באובייקט האתחול. הצופה הקודם חיפש פונקציות גלובליות שהשם שלהן נגזר ממזהה המכולה — בדף עם <div id="div_ctlDoc"> היה צורך רק להגדיר function ctlDoc_OnViewerReady(). חיפוש זה נעלם. העבר את הפונקציה במפורש:

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... your existing options ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // was found by name
    onViewerReady:    ctlDoc_OnViewerReady,     // was found by name
    onCopy:           ctlDoc_Copy,              // was ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // was ctlDoc_AutoLoadStatus(page)
});

החיפוש הישן היה עטוף ב‑catch ריק, ולכן שום דבר לא דווח. בגרסה זו הפונקציות פשוט אינן רצות: התסמין הרגיל הוא סמן טעינה שממשיך להסתובב ולא מפסיק, מכיוון שהמטפל שהסתיר אותו היה onViewerReady. המסמך מאחוריו מצויר כראוי.

אין קריאת חזרה ללחיצה על קישור — טיפול בקישורים מובנה ומופעל על‑ידי showHyperlinks.

קבוצות שיטות ציבוריות

קובץ ה‑JavaScript מכיל גם עוזרים פנימיים. יש להתייחס רק לשיטות המשמשות את ממשק המשתמש המתועד כאן או במדריכי הפיצ'רים כנקודות אינטגרציה יציבות.

ניסיון חוזר בזמן שדף מבוזר עדיין מתעבד

retryOn409 שומר על שמו ההיסטורי. הוא מיועד לייצור דפים אסינכרוני ו‑ מנסה מחדש את תגובת המוכנות 202 Accepted וכן את האות הישנה 409 Conflict.
כאשר הוא מופעל, הווידג׳ט מבצע סקרנות עם ערכי ברירת המחדל של JavaScript הבאים:

השאירו אותו מושבת עבור הצופה הרגיל בעל צומת יחיד. הפעלתו לא יכולה להפוך רינדור סינכרוני לא נתמך לאסינכרוני.

הפעילו אותו כאשר דפים מוגשים מאחסון משותף עם FirstPagePriority, שבו דפים מאוחרים יותר משיבים באופן חוקי 202 Accepted עד שהם נכתבים. לקוח שלא מנסה מחדש יציג אריחים פגומים עבור דפים שעדיין מתעבדים — ראו פריסות מבוזרות.

רשימת בדיקת נתיב

• DoconutOptions.MiddlewarePath חייב לתאר את הסניף שאתה באמת ממפה.
• BasePath חייב למקד את הסניף הזה, כתוב ללא / מוביל ('doconut', ולא '/doconut': הצופה מוסיף את הקו המפריד, ו‑//doconut/... הוא בקשה למארח אחר). היישום ההתייחסותי שומר על צורת הבקשה ההיסטורית DocImage.axd על סניף MapWhen ולכן מגדיר BasePath: '/'.
• DoconutOptions.ResourcesPath הוא נתיב המשאב המוטמע.
• ResPath בדרך כלל מכוון לתיקיית המשנה images שלו, ללא / מוביל — 'doconut-res/images' עם הקידומת המוגדרת כברירת מחדל. ResPath ריק היה נכון בספרייה הקודמת, שבה המשאבים באו משורש היישום; הוא אינו נכון כאן, והוא נכשל ללא הודעת שגיאה.
• ExtractHyperlinks חייב להיות מופעל בתצורת פורמט השרת לפני ש‑showHyperlinks יכול להציג משהו.