إعدادات العارض

ViewerConfig (المساحة Doconut) تصف مظهر وسلوك عارض المتصفح. لا يؤثر على جودة عرض المستند؛ استخدم إعداد تنسيق لذلك. فئة C# وعنصر واجهة المستخدم الجافاسكريبت القديم لديهما إعدادات افتراضية مختلفة، لذا يجب تعيين القيم صراحةً.

تغييران على جانب العميل في هذا الإصدار يفشلان بصمت. يتم تمرير دوال المعالج كخيارات — لم يعد العنصر يستخرج أسماء الدوال العالمية من معرف الحاوية — ويجب أن يشير ResPath إلى بادئة الموارد بدلاً من جذر التطبيق. كلاهما يترك الخادم يعمل بشكل كامل ولا يُظهر أي شيء في وحدة تحكم المتصفح. إذا كنت تنقل صفحة من المكتبة السابقة، اقرأ ردود النداء وقائمة التحقق من المسار قبل أي شيء آخر.

خصائص 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# إلى جافاسكريبت

الإعدادات الافتراضية لجافاسكريبت

الودجت يحتوي على إعدادات افتراضية أقدم تختلف عن فئة 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 من عرض أي شيء.