自定义主题
为查看器设置样式以匹配您的应用
查看器采用中性、基于 Bootstrap 的外观,来自嵌入资源(viewer.css),以及每个功能的样式表,如 searchBar.css 和 annotationBar.css)。主题化分为三个层级——请选择最浅的层级即可实现需求。
第一级 — 配置框架
大量的“主题化”实际上是配置:
ViewerConfig.ShowThumbs = false— 没有缩略图面板。ViewerConfig.FitType = "height" | "width"— 页面如何填充视口。- 选择性
CssConfig/ScriptConfig捆绑 — 仅保留主机使用的框架。
第二级 — 覆盖 CSS
Viewer.ReferenceCss() 会生成普通的 <link> 标签;任何在其之后加载的内容都会在层叠中获胜。使用您自己的样式表来设置查看器的大小和框架:
/* 您的样式表,在 ReferenceCss() 之后加载 */
/* 您拥有的两个容器 */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }
/* 小部件页面卡片 */
.docPage { max-width: none; }宿主页面完全控制外部布局——小部件会在您提供的任意容器 #divDocViewer / #div_ctlDoc 中渲染(来自快速入门的标准容器对)。
两个实用规则:
- 不要双重加载 Bootstrap。 如果您的应用已经包含 Bootstrap,请跳过
IncludeBootstrapCss/IncludeBootstrap,让小部件继承您的版本——仅此就能使查看器看起来原生于您的应用。 - 仅包含您使用的捆绑。 每个
CssConfig/ScriptConfig标志都是可选的;捆绑越少,需要对抗的样式越少。
第三级 — 构建您自己的工具栏
要实现完整的品牌化体验,请从您自己的 UI 驱动小部件。此类工具栏由宿主标记加上特定于应用的辅助组件组成;它不是嵌入式 SDK Ribbon。初始化返回的 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: '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 感知。
不要做的事
不要分叉或编辑嵌入的样式表:它们随包一起提供,并在每次更新时被替换。您自己样式表中的覆盖会在升级后保留;对 viewer.css 的编辑则不会。
此页面对您有帮助吗?