تم‌های سفارشی

ظاهر نمایشگر را مطابق برنامهٔ خود تنظیم کنید

نمایشگر با ظاهری خنثی و مبتنی بر 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 — ساخت نوار ابزار خودتان

برای تجربه‌ای کاملاً برندشده، ویجت را از رابط کاربری خودتان هدایت کنید. چنین نوار ابزاری ترکیبی از نشانه‌گذاری میزبان به‌اضافهٔ یک کمک‌کنندهٔ مخصوص برنامه است؛ این یک Ribbon SDK توکار نیست. نمونهٔ docViewer که پس از مقداردهی اولیه برگردانده می‌شود، سطح API شماست، به‌همراه نقاط انتهایی خودتان — در اینجا عمل ViewerApi/Open از نحوهٔ کار نمایشگر است:

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:   '/',
        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 خود را تولید می‌کنند. می‌توانید آن‌ها را همراه با نوار ابزار سفارشی نمایشگر خود استفاده کنید یا آن‌ها را نادیده بگیرید و به‌صورت مستقیم APIهای زیرساختی ویجت را فراخوانی کنید. برای ترتیب کامل یکپارچه‌سازی، به راهنمای سریع مراجعه کنید.

حالت تاریک و RTL

ویجت تم تاریک ارائه نمی‌دهد؛ بازنویسی سطح 2 که کلاس حالت‌تاریک شما (مثلاً .dark #divDocViewer { … }) را بر پس‌زمینه‌ها و حاشیه‌ها هدف‌گیری می‌کند، اکثر نیازها را پوشش می‌دهد، زیرا محتوای صفحه به‌صورت تصویر رندر می‌شود. برای میزبان‌های RTL، نمایشگر به‌خوبی داخل یک چیدمان RTL کار می‌کند — نوار ابزار خود را آگاه از RTL نگه دارید.

کارهایی که نباید انجام دهید

فورک یا ویرایش شیوه‌نامه‌های توکار را انجام ندهید: آن‌ها داخل بسته ارائه می‌شوند و در هر به‌روزرسانی جایگزین می‌شوند. بازنویسی‌ها در شیوه‌نامهٔ خودتان پس از ارتقاها باقی می‌مانند؛ ویرایش‌های viewer.css این‌گونه نیست.

آیا این صفحه مفید بود؟