Пользовательские темы
Стилизуйте просмотрщик, чтобы он соответствовал вашему приложению
Просмотрщик поставляется с нейтральным внешним видом на основе 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‑поверхностью, вместе с вашими собственными конечными точками:
<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 в Quick Start для полного порядка интеграции.
Тёмный режим и RTL
Виджет не поставляется с тёмной темой; переопределение уровня 2, нацеленное на ваш класс тёмного режима (например, .dark #divDocViewer { … }) для фонов и границ, покрывает большинство потребностей, поскольку содержимое страницы рендерится как изображения. Для хостов RTL просмотрщик прекрасно работает внутри RTL‑макета — делайте вашу собственную панель инструментов поддерживающей RTL.
Что не следует делать
Не форкайте и не редактируйте встроенные таблицы стилей: они поставляются внутри пакета и заменяются при каждом обновлении. Переопределения в вашей собственной таблице стилей сохраняются после обновлений; изменения в viewer.css — нет.
Была ли эта страница полезной?