Thèmes personnalisés
Stylez le visualiseur pour correspondre à votre application
Le visualiseur est fourni avec un aspect neutre basé sur Bootstrap, servi à partir des ressources intégrées (viewer.css, ainsi que des feuilles de style spécifiques aux fonctionnalités comme searchBar.css et annotationBar.css). La thématisation se fait à trois niveaux — choisissez le niveau le plus superficiel qui vous convient.
Niveau 1 — Configurer la chrome
Beaucoup de « thématisation » est en réalité de la configuration :
ViewerConfig.ShowThumbs = false— pas de panneau de vignettes.ViewerConfig.FitType = "height" | "width"— comment les pages remplissent la fenêtre d'affichage.- Bundles sélectifs
CssConfig/ScriptConfig— ne conservez que la chrome que votre hôte utilise.
Niveau 2 — Remplacer le CSS
Viewer.ReferenceCss() génère des balises <link> simples ; tout ce que vous chargez après elles l'emporte dans la cascade. Dimensionnez et encadrez le visualiseur à partir de votre propre feuille de style :
/* Votre feuille de style, chargée après ReferenceCss() */
/* Les deux conteneurs que vous possédez */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }
/* Cartes de page Widget */
.docPage { max-width: none; }La page hôte contrôle entièrement la mise en page extérieure — le widget s'affiche à l'intérieur de n'importe quel conteneur que vous fournissez à #divDocViewer / #div_ctlDoc (la paire de conteneurs standard du Guide de démarrage rapide).
- Ne chargez pas Bootstrap deux fois. Si votre application fournit déjà Bootstrap, ignorez
IncludeBootstrapCss/IncludeBootstrapet laissez le widget hériter du vôtre — cela suffit à rendre le visualiseur natif à votre application. - Incluez uniquement les bundles que vous utilisez. Chaque indicateur
CssConfig/ScriptConfigest optionnel ; moins de bundles, moins de styles à gérer.
Niveau 3 — Créez votre propre barre d'outils
Pour une expérience entièrement personnalisée, pilotez le widget depuis votre propre interface. Une telle barre d'outils est constituée du balisage de l'hôte plus d'un assistant spécifique à l'application ; ce n'est pas un ruban SDK intégré. L'instance docViewer renvoyée lors de l'initialisation constitue votre surface d'API, ainsi que vos propres points de terminaison — ici l'action ViewerApi/Open provenant de Comment le visualiseur fonctionne :
<div id="toolbar">
<button id="btnOpen">Open</button>
<button id="btnPrev">‹</button>
<button id="btnNext">›</button>
<!-- votre système de conception, vos icônes -->
</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: () => { /* activez vos boutons */ },
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>Recherche et Annotation sont différentes : leurs composants ruban optionnels sont intégrés dans le SDK (IncludeSearchBar, IncludeAnnotationBar) et génèrent leur propre DOM. Vous pouvez les utiliser conjointement avec votre barre d'outils personnalisée du visualiseur ou les ignorer et appeler vous‑même les API du widget sous‑jacent. Consultez le Guide de démarrage rapide pour l'ordre complet d'intégration.
Mode sombre et RTL
Le widget ne fournit pas de thème sombre ; un remplacement de Niveau 2 ciblant votre classe de mode sombre (par ex. .dark #divDocViewer { … }) sur les arrière‑plans et les bordures couvre la plupart des besoins, puisque le contenu de la page lui‑même est rendu sous forme d'images. Pour les hôtes RTL, le visualiseur fonctionne parfaitement à l'intérieur d'une mise en page RTL — assurez‑vous que votre propre barre d'outils soit compatible RTL.
Ce qu'il ne faut pas faire
Ne dupliquez pas et ne modifiez pas les feuilles de style intégrées : elles sont fournies dans le paquet et remplacées à chaque mise à jour. Les remplacements dans votre propre feuille de style survivent aux mises à niveau ; les modifications de viewer.css, non.
Cette page était-elle utile ?