سمات مخصصة

صمم عارض المستندات ليتناسب مع تطبيقك

يأتي العارض بمظهر محايد يعتمد على Bootstrap يتم تقديمه من الموارد المدمجة (viewer.css، بالإضافة إلى أوراق الأنماط الخاصة بالميزات مثل searchBar.css وannotationBar.css). يتم تطبيق السمات على ثلاثة مستويات — اختر المستوى الأقل الذي يحقق ما تحتاجه.

المستوى 1 — ضبط الإطار

  • ViewerConfig.ShowThumbs = false — بدون لوحة الصور المصغرة.
  • ViewerConfig.FitType = "height" | "width" — كيفية ملء الصفحات لواجهة العرض.
  • حزم CssConfig/ScriptConfig الانتقائية — احتفظ فقط بالإطار الذي يستخدمه المضيف.

المستوى 2 — تجاوز CSS

Viewer.ReferenceCss() ينتج وسوم <link> عادية؛ أي شيء تقوم بتحميله بعدها يتفوق في السلسلة. قم بتحديد حجم وإطار العارض من خلال ورقة الأنماط الخاصة بك:

css
/* ورقة الأنماط الخاصة بك، تم تحميلها بعد ReferenceCss() */

/* الحاويتان التي تملكها */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }

/* بطاقات صفحة الودجت */
.docPage { max-width: none; }

تتحكم صفحة المضيف في التخطيط الخارجي بالكامل — يتم عرض الودجت داخل أي صندوق تمنحه لـ #divDocViewer / #div_ctlDoc (زوج الحاويات القياسي من دليل البداية السريعة).

قاعدتان عمليتان:

  • لا تقم بتحميل Bootstrap مرتين. إذا كان تطبيقك يضم Bootstrap بالفعل، فتخطى IncludeBootstrapCss/IncludeBootstrap ودع الودجت يرث النسخة الخاصة بك — هذا وحده يجعل العارض يبدو أصليًا لتطبيقك.
  • قم بتضمين الحزم التي تستخدمها فقط. كل علم CssConfig/ScriptConfig هو اختيار اختياري؛ كلما قل عدد الحزم، قل عدد الأنماط التي تحتاج لمواجهتها.

المستوى 3 — أنشئ شريط أدواتك الخاص

للحصول على تجربة مميزة بالكامل، قم بالتحكم في الودجت من واجهتك الخاصة. مثل هذا الشريط هو تعليمات مضيف بالإضافة إلى مساعد خاص بالتطبيق؛ ليس شريطًا مضمنًا من SDK. كائن docViewer الذي يُرجع عند التهيئة هو واجهة برمجة التطبيقات الخاصة بك، إلى جانب نقاط النهاية الخاصة بك:

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>

البحث والتعليق مختلفان: مكوّنات Ribbon الاختيارية الخاصة بهما مدمجة في SDK (IncludeSearchBar، IncludeAnnotationBar) وتولد DOM خاص بها. يمكنك استخدامها مع شريط أدوات العارض المخصص أو تخطيها واستدعاء واجهات برمجة التطبيقات للودجت الأساسية بنفسك. راجع حزمة العارض الكاملة في دليل البداية السريعة للحصول على ترتيب التكامل الكامل.

الوضع الداكن وRTL

الودجت لا يأتي بموضوع داكن؛ تجاوز المستوى 2 المستهدف لفئة الوضع الداكن الخاصة بك (مثال: .dark #divDocViewer { … }) على الخلفيات والحدود يغطي معظم الاحتياجات، لأن محتوى الصفحة نفسه يُعرض كصور. بالنسبة للمضيفين الذين يستخدمون RTL، يعمل العارض بسلاسة داخل تخطيط RTL — احرص على أن يكون شريط أدواتك مدركًا لـ RTL.

ما يجب تجنبه

لا تقم بعمل فرع أو تعديل أوراق الأنماط المدمجة: فهي تُضمّن داخل الحزمة وتُستبدل في كل تحديث. التجاوزات في ورقة الأنماط الخاصة بك تبقى بعد الترقيات؛ التعديلات على viewer.css لا تفعل ذلك.

هل كانت هذه الصفحة مفيدة؟