تكوين العارض

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

لا تمرر ViewerConfig المتسلسل مباشرةً إلى docViewer(...). معظم مفاتيح العنصر هي camelCase، بينما ثلاثة مفاتيح مسار/ملاءمة معروفة هي PascalCase.

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

الودجت يحتوي على إعدادات افتراضية أقدم تختلف عن فئة 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({
    // ... خياراتك الحالية ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // تم العثور عليه بالاسم
    onViewerReady:    ctlDoc_OnViewerReady,     // تم العثور عليه بالاسم
    onCopy:           ctlDoc_Copy,              // كان ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // كان ctlDoc_AutoLoadStatus(page)
});

كان البحث القديم ملفوفًا داخل catch فارغ، لذا لم يتم الإبلاغ عن أي شيء. في هذا الإصدار لا تُنفّذ الدوال مطلقًا: العرض المعتاد هو مؤشر تحميل مشغول لا يتوقف أبدًا، لأن المعالج الذي كان يخفيه كان onViewerReady. المستند خلفه يتم عرضه بشكل صحيح.

لا توجد ردّة نداء للنقر على الروابط — معالجة الروابط مدمجة وتُدار بواسطة showHyperlinks.

مجموعات الطرق العامة

يحتوي ملف JavaScript أيضًا على مساعدات داخلية. اعتبر فقط الطرق المستخدمة من قبل واجهة المستخدم المرجعية والموثقة هنا أو في أدلة الميزات كنقاط تكامل ثابتة.

إعادة المحاولة أثناء استمرار عرض صفحة موزعة

retryOn409 يحتفظ باسمه التاريخي. هو مخصص لإنتاج الصفحات غير المتزامن ويعيد محاولة استجابة جاهزية 202 Accepted الحالية وكذلك إشارة 409 Conflict القديمة. عند التفعيل، يقوم الودجت بالاستطلاع باستخدام هذه القيم الافتراضية لجافاسكريبت:

اتركه معطلاً للعارض العادي أحادي العقدة. تمكينه لا يمكن أن يجعل عرضًا متزامنًا غير مدعوم يتحول إلى غير متزامن.

فعّله عندما تُقدم الصفحات من تخزين مشترك باستخدام FirstPagePriority، حيث تُجيب الصفحات اللاحقة بصورة شرعية على 202 Accepted حتى تُكتب. العميل الذي لا يعيد المحاولة يُظهر بلاطات مكسورة للصفحات التي لا تزال تُعرض — راجع التوزيعات الموزعة.

قائمة التحقق من المسار

• DoconutOptions.MiddlewarePath يجب أن يصف الفرع الذي تقوم بربطه فعليًا.
• BasePath يجب أن يستهدف ذلك الفرع، مكتوبًا بدون / الأولي ('doconut'، وليس '/doconut': يضيف العارض الشرطة المائلة، و//doconut/... هو طلب إلى مضيف آخر). التطبيق المرجعي يحتفظ بشكل طلب DocImage.axd التاريخي على فرع MapWhen وبالتالي يضبط BasePath: '/'.
• DoconutOptions.ResourcesPath هو مسار المورد المضمن.
• ResPath عادةً ما يستهدف المجلد الفرعي images الخاص به، بدون / أولي — 'doconut-res/images' مع البادئة الافتراضية. كان ResPath الفارغ صحيحًا في المكتبة السابقة، حيث كانت الموارد تأتي من جذر التطبيق؛ لكنه غير صحيح هنا، ويتسبب في فشل دون ظهور خطأ.
• ExtractHyperlinks يجب أن يكون مفعلاً في إعداد تنسيق الخادم قبل أن يتمكن showHyperlinks من عرض أي شيء.