Temas Personalizados

Estiliza el visor para que coincida con tu aplicación

El visor se entrega con un aspecto neutro basado en Bootstrap, servido desde los recursos incrustados (viewer.css, además de hojas de estilo por característica como searchBar.css y annotationBar.css). La tematización ocurre en tres niveles — elige el más superficial que te lleve allí.

Nivel 1 — Configura la interfaz

Mucho de la "tematización" es realmente configuración:

  • ViewerConfig.ShowThumbs = false — sin panel de miniaturas.
  • ViewerConfig.FitType = "height" | "width" — cómo las páginas llenan la ventana gráfica.
  • Paquetes selectivos CssConfig/ScriptConfig — conserva solo la interfaz que usa tu host.

Nivel 2 — Sobrescribir el CSS

Viewer.ReferenceCss() emite etiquetas <link> simples; cualquier cosa que cargues después de ellas gana la cascada. Ajusta el tamaño y el marco del visor desde tu propia hoja de estilo:

css
/* Tu hoja de estilo, cargada después de ReferenceCss() */

/* Los dos contenedores que posees */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }

/* Tarjetas de página de Widget */
.docPage { max-width: none; }

La página host controla completamente el diseño externo — el widget se renderiza dentro de cualquier contenedor que le des a #divDocViewer / #div_ctlDoc (el par de contenedores estándar del Inicio Rápido).

Dos reglas prácticas:

  • No cargues Bootstrap dos veces. Si tu aplicación ya incluye Bootstrap, omite IncludeBootstrapCss/IncludeBootstrap y permite que el widget herede el tuyo — esto por sí solo hace que el visor parezca nativo de tu aplicación.
  • Incluye solo los paquetes que utilizas. Cada bandera CssConfig/ScriptConfig es opcional; menos paquetes, menos estilos contra los que luchar.

Nivel 3 — Construye tu propia barra de herramientas

Para una experiencia totalmente personalizada, controla el widget desde tu propia UI. Esa barra de herramientas es marcado del host más un ayudante específico de la aplicación; no es una cinta SDK incrustada. La instancia docViewer devuelta por la inicialización es tu superficie API, junto con tus propios puntos finales — aquí la acción ViewerApi/Open de Cómo funciona el visor:

html
<div id="toolbar">
    <button id="btnOpen">Open</button>
    <button id="btnPrev">‹</button>
    <button id="btnNext">›</button>
    <!-- tu sistema de diseño, tus íconos -->
</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: () => { /* habilita tus botones */ },
        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>

Buscar y Anotar son diferentes: sus componentes de cinta opcionales están incrustados en el SDK (IncludeSearchBar, IncludeAnnotationBar) y generan su propio DOM. Puedes usarlos junto con tu barra de herramientas personalizada del Visor o omitirlos y llamar tú mismo a las API subyacentes del widget. Consulta el Inicio rápido para el orden completo de integración.

Modo oscuro y RTL

El widget no incluye un tema oscuro; una sobrescritura de Nivel 2 que apunte a tu clase de modo oscuro (p. ej., .dark #divDocViewer { … }) en fondos y bordes cubre la mayoría de las necesidades, ya que el contenido de la página se renderiza como imágenes. Para hosts RTL, el visor funciona perfectamente dentro de un diseño RTL — mantén tu propia barra de herramientas consciente de RTL.

Qué no hacer

No bifurques ni edites las hojas de estilo incrustadas: se entregan dentro del paquete y se reemplazan en cada actualización. Las sobrescrituras en tu propia hoja de estilo sobreviven a las actualizaciones; las ediciones a viewer.css no.

¿Fue útil esta página?