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). A tematização ocorre em três níveis — escolha o mais superficial que atenda às suas necessidades.

Nível 1 — Configurar a estrutura

Muita da "tematização" é realmente configuração:

  • ViewerConfig.ShowThumbs = false — sem painel de miniaturas.
  • ViewerConfig.FitType = "height" | "width" — como as páginas preenchem a área de visualização.
  • Pacotes seletivos CssConfig/ScriptConfig — mantenha apenas a estrutura que seu host usa.

Nível 2 — Substituir o CSS

Viewer.ReferenceCss() emite tags <link> simples; tudo o que você carregar depois delas vence a cascata. Defina o tamanho e a moldura do visualizador a partir da sua própria folha de estilo:

css
/* Sua folha de estilo, carregada após ReferenceCss() */

/* Os dois containers que você possui */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }

/* Cartões de página de widget */
.docPage { max-width: none; }

A página host controla totalmente 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 Guia de Início Rápido).

Dois regras práticas:

  • Não carregue o Bootstrap duas vezes. Se seu aplicativo já inclui o Bootstrap, pule IncludeBootstrapCss/IncludeBootstrap e 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 combater.

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 interface de usuário. 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, juntamente com seus próprios endpoints:

html
<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 você mesmo. Veja o pacote completo do Viewer no Guia de Início Rápido 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 direcionada à 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 em si é 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 entregues dentro do pacote e são substituídas a cada atualização. Substituições na sua própria folha de estilo sobrevivem às atualizações; edições em viewer.css não.

Esta página foi útil?