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

ظاهر نمایشگر را مطابق برنامه‌تان تنظیم کنید

نمایشگر با ظاهری خنثی و مبتنی بر 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 شماست، به‌همراه نقاط پایانی خودتان:

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

حالت تاریک و RTL

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

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

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

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