سمات مخصصة
صمم عارض الوثائق ليتطابق مع تطبيقك
يأتي العارض بمظهر محايد يعتمد على 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 الذي يُرجع عند التهيئة هو واجهة برمجة التطبيقات الخاصة بك، إلى جانب نقاط النهاية الخاصة بك — هنا إجراء ViewerApi/Open من كيف يعمل العارض:
<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('/ViewerApi/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 لا تبقى.
هل كانت هذه الصفحة مفيدة؟