سمات مخصصة
صمم العارض ليتناسب مع تطبيقك
يأتي العارض بمظهر محايد يعتمد على 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); }
/* بطاقات صفحة الودجت */
.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: '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.
ما لا يجب فعله
لا تقم بعمل Fork أو تعديل أوراق الأنماط المدمجة: فهي تُرسل داخل الحزمة وتُستبدل في كل تحديث. التجاوزات في ورقة الأنماط الخاصة بك تبقى بعد الترقيات؛ التعديلات على viewer.css لا تفعل ذلك.
هل كانت هذه الصفحة مفيدة؟