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:
/* 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/IncludeBootstrapy 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/ScriptConfiges 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:
<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?