ViewerConfig

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

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

מאפייני C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "/doconut",
    ResPath = "/doconut-res/images",
    ShowHyperlinks = true
};

מיפוי C# ל‑JavaScript

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

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