Користувацькі теми
Стилізуйте переглядач, щоб він відповідав вашому застосунку
Переглядач постачається з нейтральним, основаним на 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 (стандартна пара контейнерів з Quick Start).
Два практичних правила:
- Не завантажуйте Bootstrap двічі. Якщо ваш застосунок вже постачається з Bootstrap, пропустіть
IncludeBootstrapCss/IncludeBootstrapі дозволіть віджету успадкувати ваш — це саме по собі робить вигляд переглядача нативним для вашого застосунку. - Включайте лише ті пакети, які використовуєте. Кожен прапорець
CssConfig/ScriptConfigє опціональним; менше пакетів — менше стилів, з якими треба боротися.
Рівень 3 — Створіть власну панель інструментів
Для повністю брендованого досвіду керуйте віджетом зі свого інтерфейсу. Така панель інструментів — це розмітка хоста плюс специфічний для застосунку помічник; це не вбудована стрічка SDK. Екземпляр docViewer, який повертається після ініціалізації, є вашою API‑поверхнею разом із вашими власними кінцевими точками — ось дія ViewerApi/Open з How the Viewer Works:
<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. Ви можете використовувати їх разом зі своєю власною панеллю інструментів Viewer або пропустити їх і викликати базові API віджету самостійно. Дивіться Quick Start для повного порядку інтеграції.
Темний режим і RTL
Віджет не постачається з темною темою; перевизначення рівня 2, яке націлюється на ваш клас темного режиму (наприклад, .dark #divDocViewer { … }) для фонів і меж, покриває більшість потреб, оскільки вміст сторінки сам по собі відображається у вигляді зображень. Для хостів RTL переглядач без проблем працює всередині RTL‑розмітки — забезпечте, щоб ваша власна панель інструментів була RTL‑сумісною.
Чого не варто робити
Не форкуйте і не редагуйте вбудовані таблиці стилів: вони постачаються всередині пакету і замінюються при кожному оновленні. Перевизначення у вашій власній таблиці стилів залишаються після оновлень; зміни у viewer.css — ні.
Чи була ця сторінка корисною?