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 widget JavaScript de longue date ont des valeurs par défaut différentes, il faut donc mapper les valeurs explicitement.

Deux changements côté client dans cette version échouent silencieusement. Les fonctions gestionnaires sont passées en tant qu'options — le widget ne dérive plus les noms de fonctions globales à partir de l'ID du conteneur — et ResPath doit pointer vers le préfixe des ressources plutôt que vers la racine de l'application. Les deux laissent le serveur fonctionner parfaitement et ne signalent rien dans la console du navigateur. Si vous migrez une page depuis la bibliothèque précédente, lisez Rappels et Liste de contrôle des chemins avant toute chose.

Propriétés C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "doconut",           // pas de '/' initial : le visualiseur l'ajoute ("\/doconut" deviendrait //doconut, un autre hôte)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

Mapping C# vers JavaScript

Ne passez pas un ViewerConfig sérialisé directement à 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 de 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: 'doconut',
    ResPath: 'doconut-res/images',
    onViewerReady: function () {},
    onError: function (message) { console.error('DocViewer:', message); }
});
</script>

Rappels

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

Chacun de ceux-ci est une option sur l'objet d'initialisation. Le visualiseur précédent recherchait des fonctions globales dont les noms étaient dérivés de l'ID du conteneur — une page avec <div id="div_ctlDoc"> devait seulement déclarer function ctlDoc_OnViewerReady(). Cette recherche a disparu. Passez la fonction explicitement :

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... vos options existantes ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // était trouvé par son nom
    onViewerReady:    ctlDoc_OnViewerReady,     // était trouvé par son nom
    onCopy:           ctlDoc_Copy,              // était ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // était ctlDoc_AutoLoadStatus(page)
});

L'ancienne recherche était enveloppée dans un catch vide, donc rien n'était jamais signalé. Dans cette version, les fonctions ne s'exécutent tout simplement jamais : le symptôme habituel est un indicateur d'activité qui ne s'arrête jamais, parce que le gestionnaire qui le cachait était onViewerReady. Le document derrière s'affiche correctement.

Il n'existe aucun rappel de clic de lien — la gestion des hyperliens est intégrée et pilotée par showHyperlinks.

Groupes de méthodes publiques

Le fichier JavaScript contient également des aides internes. Ne considérez comme points d’intégration stables que les méthodes utilisées par l’interface de référence et documentées ici ou dans les guides de fonctionnalités.

Réessayer pendant qu’une page distribuée est encore en cours de rendu

retryOn409 conserve son nom historique. Il sert à la production asynchrone de pages et réessaye la réponse de disponibilité actuelle 202 Accepted ainsi que le signal plus ancien 409 Conflict. Lorsqu’il est activé, le widget interroge avec ces valeurs par défaut JavaScript :

Laissez‑le désactivé pour le visualiseur mono‑noeud normal. L’activer ne peut pas rendre asynchrone un rendu synchrone non pris en charge.

Activez‑le lorsque les pages sont servies depuis un stockage partagé avec FirstPagePriority, où les pages suivantes répondent légitimement 202 Accepted jusqu’à leur écriture. Un client qui ne réessaye pas affichera des tuiles cassées pour les pages encore en cours de rendu — voir Déploiements distribués(Distributed Deployments).

Liste de contrôle du chemin

• DoconutOptions.MiddlewarePath doit décrire la branche que vous mappez réellement.
• BasePath doit cibler cette branche, écrite sans slash initial / ('doconut', pas '/doconut' : le visualiseur ajoute le slash, et //doconut/... constitue une requête vers un autre hôte). L’application de référence conserve la forme historique de requête DocImage.axd sur une branche MapWhen et définit donc BasePath: '/'.
• DoconutOptions.ResourcesPath est la route des ressources embarquées.
• ResPath cible normalement son sous‑dossier images, sans slash initial — 'doconut-res/images' avec le préfixe par défaut. Un ResPath vide était correct dans la bibliothèque précédente, où les ressources provenaient de la racine de l’application ; ce n’est pas correct ici, et cela échoue sans générer d’erreur.
• ExtractHyperlinks doit être activé dans la configuration du format serveur avant que showHyperlinks puisse afficher quoi que ce soit.