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

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

نمایشگر با ظاهری خنثی و مبتنی بر Bootstrap ارائه می‌شود که از منابع جاسازی‌شده (viewer.css، به‌همراه سبک‌برگ‌های ویژگی‌محور مانند searchBar.css و annotationBar.css) سرویس می‌گیرد. تم‌سازی در سه سطح انجام می‌شود — سطح کم‌عمقی که نیاز شما را برآورده می‌کند، انتخاب کنید.

Level 1 — پیکربندی کروم

بخش زیادی از «تم‌سازی» در واقع پیکربندی است:

  • ViewerConfig.ShowThumbs = false — بدون پنل تصویر بندانگشتی.
  • ViewerConfig.FitType = "height" | "width" — نحوه پر شدن صفحات در پنجره نمایش.
  • بسته‌های انتخابی CssConfig/ScriptConfig — فقط کرومی را که میزبان شما استفاده می‌کند، نگه دارید.

Level 2 — بازنویسی CSS

Viewer.ReferenceCss() تگ‌های ساده <link> تولید می‌کند؛ هر چیزی که پس از آن‌ها بارگذاری کنید، بر سلسله‌مراتب غلبه می‌کند. اندازه و قاب نمایشگر را از طریق سبک‌برگ خود تنظیم کنید:

css
/* شیوه‌نامهٔ شما، پس از ReferenceCss() بارگذاری می‌شود */

/* دو کانتینری که شما مالک آن‌ها هستید */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }

/* کارت‌های صفحهٔ Widget */
.docPage { max-width: none; }

صفحه میزبان کل طرح بیرونی را به‌طور کامل کنترل می‌کند — ویجت داخل هر جعبه‌ای که به #divDocViewer / #div_ctlDoc می‌دهید رندر می‌شود (جفت کانتینر استاندارد از راه‌اندازی سریع).

دو قانون عملی:

  • بارگذاری دوباره Bootstrap را نکنید. اگر برنامه شما قبلاً Bootstrap را شامل می‌شود، از IncludeBootstrapCss/IncludeBootstrap عبور کنید و اجازه دهید ویجت از نسخه شما ارث‌بری کند — این به تنهایی باعث می‌شود نمایشگر همانند بومی برنامه شما به نظر برسد.
  • فقط بسته‌هایی را که استفاده می‌کنید شامل کنید. هر پرچم CssConfig/ScriptConfig به‌صورت انتخابی فعال است؛ هرچه بسته‌ها کمتر باشند، سبک‌های کمتری برای مقابله وجود دارد.

Level 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 این‌گونه نیست.

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