Temas Personalizados
Estilize o visualizador para combinar com seu aplicativo
O visualizador vem com um visual neutro, baseado em Bootstrap, servido a partir dos recursos incorporados (viewer.css, além de folhas de estilo por recurso como searchBar.css e annotationBar.css). O tema ocorre em três níveis — escolha o mais superficial que lhe atender.
Nível 1 — Configure o chrome
ViewerConfig.ShowThumbs = false— sem painel de miniaturas.ViewerConfig.FitType = "height" | "width"— como as páginas preenchem a viewport.- Pacotes seletivos
CssConfig/ScriptConfig— mantenha apenas o chrome que seu host usa.
Nível 2 — Substitua o CSS
Viewer.ReferenceCss() emite tags <link> simples; tudo o que você carregar depois delas vence a cascata. Dimensione e enquadre o visualizador a partir da sua própria folha de estilos:
/* Sua folha de estilo, carregada após ReferenceCss() */
/* Os dois contêineres que você possui */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }
/* Cartões da página de widget */
.docPage { max-width: none; }A página host controla completamente o layout externo — o widget renderiza dentro de qualquer caixa que você forneça #divDocViewer / #div_ctlDoc (o par de contêiner padrão do Quick Start).
Duas regras práticas:
- Não carregue o Bootstrap duas vezes. Se seu aplicativo já inclui Bootstrap, pule
IncludeBootstrapCss/IncludeBootstrape deixe o widget herdar o seu — isso por si só faz o visualizador parecer nativo ao seu aplicativo. - Inclua apenas os pacotes que você usa. Cada sinalizador
CssConfig/ScriptConfigé opcional; menos pacotes, menos estilos para lidar.
Nível 3 — Crie sua própria barra de ferramentas
Para uma experiência totalmente personalizada, controle o widget a partir da sua própria UI. Essa barra de ferramentas é a marcação do host mais um auxiliar específico do aplicativo; não é uma Ribbon SDK incorporada. A instância docViewer retornada pela inicialização é a sua superfície de API, junto com seus próprios endpoints:
<div id="toolbar">
<button id="btnOpen">Open</button>
<button id="btnPrev">‹</button>
<button id="btnNext">›</button>
<!-- Seu sistema de design, seus ícones -->
</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: () => { /* Habilite seus botões */ },
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>Busca e Anotação são diferentes: seus componentes Ribbon opcionais são incorporados ao SDK (IncludeSearchBar, IncludeAnnotationBar) e geram seu próprio DOM. Você pode usá‑los junto com sua barra de ferramentas personalizada do Viewer ou ignorá‑los e chamar as APIs subjacentes do widget diretamente. Veja o pacote completo do Viewer no Quick Start para a ordem completa de integração.
Modo escuro e RTL
O widget não inclui um tema escuro; uma substituição de Nível 2 que visa sua classe de modo escuro (por exemplo, .dark #divDocViewer { … }) em fundos e bordas cobre a maioria das necessidades, já que o conteúdo da página é renderizado como imagens. Para hosts RTL, o visualizador funciona perfeitamente dentro de um layout RTL — mantenha sua própria barra de ferramentas ciente de RTL.
O que não fazer
Não faça fork nem edite as folhas de estilo incorporadas: elas são distribuídas dentro do pacote e são substituídas a cada atualização. Substituições na sua própria folha de estilos sobrevivem às atualizações; edições em viewer.css não.
Esta página foi útil?