سمات مخصصة
صمم العارض ليتطابق مع تطبيقك
يأتي العارض بمظهر محايد يعتمد على Bootstrap يتم تقديمه من الموارد المدمجة (viewer.css، بالإضافة إلى أوراق الأنماط الخاصة بكل ميزة مثل searchBar.css وannotationBar.css). يتم تطبيق السمات على ثلاثة مستويات — اختر المستوى الأقل عمقًا الذي يلبي احتياجاتك.
المستوى 1 — ضبط الإطار
الكثير من "التصميم" هو في الواقع تكوين:
ViewerConfig.ShowThumbs = false— بدون لوحة المصغرات.ViewerConfig.FitType = "height" | "width"— كيفية ملء الصفحات لواجهة العرض.- حزم
CssConfig/ScriptConfigالانتقائية — احتفظ فقط بالإطار الذي يستخدمه المضيف.
المستوى 2 — تجاوز CSS
Viewer.ReferenceCss() ينتج وسوم <link> عادية؛ أي شيء تقوم بتحميله بعدها سيفوز في السلسلة. حدد الحجم وإطار العارض من خلال ورقة الأنماط الخاصة بك:
/* ورقة الأنماط الخاصة بك، تم تحميلها بعد ReferenceCss() */
/* الحاويتان التي تملكها */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }
/* بطاقات صفحة Widget */
.docPage { max-width: none; }تتحكم صفحة المضيف في التخطيط الخارجي بالكامل — يتم عرض الودجت داخل أي صندوق تمنحه لـ #divDocViewer / #div_ctlDoc (زوج الحاويات القياسي من البداية السريعة).
قاعدتان عمليتان:
- لا تقم بتحميل Bootstrap مرتين. إذا كان تطبيقك يشتمل بالفعل على Bootstrap، فتجاوز
IncludeBootstrapCss/IncludeBootstrapودع الودجت يرث النسخة الخاصة بك — هذا وحده يجعل العارض يبدو أصليًا لتطبيقك. - قم بتضمين الحزم التي تستخدمها فقط. كل علم
CssConfig/ScriptConfigهو اختيار اختياري؛ كلما قل عدد الحزم، قل عدد الأنماط التي تحتاج لمواجهتها.
المستوى 3 — بناء شريط أدواتك الخاص
للحصول على تجربة مميزة بالكامل، قم بالتحكم في الودجت من واجهتك الخاصة. مثل هذا الشريط هو تعليمات مضيف بالإضافة إلى مساعد خاص بالتطبيق؛ ليس شريطًا مضمنًا من SDK. المثيل docViewer الذي يتم إرجاعه بعد التهيئة هو واجهة برمجة التطبيقات الخاصة بك، إلى جانب نقاط النهاية الخاصة بك:
<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: '/',
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 لا تفعل ذلك.
هل كانت هذه الصفحة مفيدة؟