ViewerConfig

ViewerConfig (namespace Doconut) describe la apariencia y el comportamiento del visualizador del navegador. No afecta la calidad de renderizado del documento; use una configuración de formato para eso. La clase C# y el plugin JavaScript heredado tienen valores predeterminados diferentes, por lo que debe mapear los valores explícitamente.

Propiedades C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "/",                 // "/" = el controlador DocImage.axd en la raíz del sitio (Web.config)
    ResPath = "doconut-res/images", // la carpeta de imágenes bajo ResourcesPath, sin '/' inicial
    ShowHyperlinks = true
};
// Emítalo con viewer.RenderViewer("viewerEl", token, config) - vea la referencia del Visor.

Emitir un ViewerConfig con RenderViewer

Viewer.RenderViewer(elementId, token, config) convierte un ViewerConfig en el script de inicialización del widget. Escribe seis de las propiedades anteriores — BasePath, ResPath, ShowThumbs, AutoLoad, PageZoom y FitType — y luego llama a View(token). Las demás propiedades no se escriben: para MaxZoom, ShowHyperlinks, los ajustes de zoom o cualquier callback, inicialice el widget usted mismo con las opciones JavaScript a continuación. Consulte Visor para RenderViewer.

Mapeo de C# a JavaScript

No pase un ViewerConfig serializado directamente a docViewer(...). La mayoría de las claves del widget están en camelCase, mientras que tres claves establecidas de ruta/ajuste están en PascalCase.

Valores predeterminados de JavaScript

El widget tiene valores predeterminados más antiguos que difieren de la clase C#. Los siguientes valores provienen de la implementación actual de docViewer.js.

Establezca todos los valores importantes de comportamiento en lugar de depender de cualquiera de los conjuntos de valores predeterminados:

<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>

Funciones de devolución de llamada

Mantenga los callbacks rápidos; envíe telemetría de forma asíncrona y no bloquee la renderización de la página.

Grupos de métodos públicos

El archivo JavaScript también contiene ayudantes internos. Trate solo los métodos utilizados por la UI de referencia y documentados aquí o en las guías de características como puntos de integración estables.

Opciones de reintento

El widget también acepta retryOn409 y sus configuraciones de retroceso (retryInitialDelayMs, retryBackoffFactor, retryMaxDelayMs, retryMaxAttempts, retryMaxTotalMs). Sirven a implementaciones cuyas páginas se generan en segundo plano. DocImage.axd renderiza cada página durante la solicitud, por lo que deje retryOn409 desactivado.

Lista de verificación de rutas

• BasePath es '/' cuando el controlador DocImage.axd está en la raíz del sitio — el atributo path del controlador en Web.config decide dónde responde. En un directorio virtual, use el nombre del directorio sin una barra inicial / ('myapp', no '/myapp': el visualizador agrega la barra, y //myapp/... es una solicitud a otro host).
• DoconutOptions.ResourcesPath es donde el módulo de recursos sirve los archivos incrustados (/doconut-res por defecto).
• ResPath apunta a su subcarpeta images, también sin una barra inicial / ('doconut-res/images'). Apuntarlo a 'doconut-res' hace que cada ícono devuelva 404 mientras el documento aún se renderiza.
• En MVC, routes.IgnoreRoute("doconut-res/{*pathInfo}") debe seguir a ResourcesPath si lo cambias.
• ExtractHyperlinks debe estar habilitado en la configuración del formato del servidor antes de que showHyperlinks pueda mostrar algo.