قالب‌های سفارشی

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

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

Level 1 — Configure the chrome

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

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

Level 2 — Override the 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 به‌صورت اختیاری است؛ بسته‌های کمتر، سبک‌های کمتری برای مقابله.

Level 3 — Build your own toolbar

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

Dark mode and RTL

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

What not to do

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

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