ViewerConfig

ViewerConfig (namespace Doconut) décrit l'apparence et le comportement du visualiseur du navigateur. Il n'affecte pas la qualité du rendu du document ; utilisez une configuration de format pour cela. La classe C# et le plugin JavaScript hérité ont des valeurs par défaut différentes, il faut donc mapper les valeurs explicitement.

Propriétés C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "/",                 // "/" = le gestionnaire DocImage.axd à la racine du site (Web.config)
    ResPath = "doconut-res/images", // le dossier images sous ResourcesPath, pas de '/' initial
    ShowHyperlinks = true
};
// Émettez‑le avec viewer.RenderViewer("viewerEl", token, config) - voir la référence Viewer.

Générer un ViewerConfig avec RenderViewer

Viewer.RenderViewer(elementId, token, config) transforme un ViewerConfig en script d'initialisation du widget. Il écrit six des propriétés ci‑dessus — BasePath, ResPath, ShowThumbs, AutoLoad, PageZoom et FitType — puis appelle View(token). Les autres propriétés ne sont pas écrites : pour MaxZoom, ShowHyperlinks, les réglages de zoom, ou tout rappel, initialisez le widget vous‑même avec les options JavaScript ci‑dessous. Voir Visionneuse pour RenderViewer.

Correspondance C# vers JavaScript

Ne transmettez pas un ViewerConfig directement sérialisé à docViewer(...). La plupart des clés du widget sont en camelCase, tandis que trois clés de chemin/ajustement établies sont en PascalCase.

Valeurs par défaut JavaScript

Le widget possède des valeurs par défaut plus anciennes qui diffèrent de la classe C#. Les valeurs suivantes proviennent de l'implémentation actuelle docViewer.js.

Définissez toutes les valeurs importantes du comportement au lieu de vous fier à l'un ou l'autre des ensembles de valeurs par défaut :

<div id="divDocViewer"><div id="div_ctlDoc"></div></div>

<script>
const objViewer = $('#div_ctlDoc').docViewer({
    showThumbs: true,
    autoLoad: false,
    autoFocus: true,
    autoPageFocus: true,
    pageZoom: 100,
    zoomStep: 10,
    maxZoom: 300,
    FitType: 'width',
    cacheEnabled: false,
    largeDoc: false,
    showHyperlinks: true,
    fixedZoom: true,
    fixedZoomPercent: 100,
    fixedZoomPercentMobile: 75,
    BasePath: '/',
    ResPath: 'doconut-res/images',
    onViewerReady: function () {},
    onError: function (message) { console.error('DocViewer:', message); }
});
</script>

Rappels

Gardez les rappels rapides ; envoyez la télémétrie de façon asynchrone et ne bloquez pas le rendu des pages.

Groupes de méthodes publiques

Le fichier JavaScript contient également des aides internes. Considérez uniquement les méthodes utilisées par l'interface de référence et documentées ici ou dans les guides fonctionnels comme des points d'intégration stables.

Options de réessai

Le widget accepte également retryOn409 et ses paramètres de temporisation (retryInitialDelayMs, retryBackoffFactor, retryMaxDelayMs, retryMaxAttempts, retryMaxTotalMs). Ils servent les déploiements dont les pages sont générées en arrière-plan. DocImage.axd rend chaque page pendant la requête, donc laissez retryOn409 désactivé.

Liste de contrôle des chemins

• BasePath est '/' lorsque le gestionnaire DocImage.axd se trouve à la racine du site — l'attribut path du gestionnaire dans Web.config détermine où il répond. Dans un répertoire virtuel, utilisez le nom du répertoire sans / initial ('myapp', pas '/myapp' : le visualiseur ajoute la barre oblique, et //myapp/... est une requête vers un autre hôte).
• DoconutOptions.ResourcesPath est l'endroit où le module de ressources sert les fichiers intégrés (/doconut-res par défaut).
• ResPath cible son sous-dossier images, également sans / initial ('doconut-res/images'). Le pointer vers 'doconut-res' entraîne un 404 pour chaque icône alors que le document continue de s'afficher.
• En MVC, routes.IgnoreRoute("doconut-res/{*pathInfo}") doit suivre ResourcesPath si vous le modifiez.
• ExtractHyperlinks doit être activé dans la configuration du format serveur avant que showHyperlinks puisse afficher quoi que ce soit.