ConfiguraciónDelVisor

ViewerConfig (namespace Doconut) describe la apariencia y el comportamiento del visor 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, así que mapee los valores explícitamente.

Propiedades C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "doconut",           // sin '/' inicial: el visor lo agrega ("/doconut" se convertiría en //doconut, otro host)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

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: 'doconut',
    ResPath: 'doconut-res/images',
    onViewerReady: function () {},
    onError: function (message) { console.error('DocViewer:', message); }
});
</script>

Funciones de devolución

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.

Reintentar después de HTTP 409

retryOn409 es para la producción de páginas asíncrona. Cuando está habilitado, el widget realiza sondeos con estos valores predeterminados de JavaScript:

Déjelo deshabilitado para el visor normal. Habilitarlo no puede convertir una renderización sincrónica no compatible en asíncrona.

Lista de verificación de rutas

• DoconutOptions.MiddlewarePath debe describir la rama que realmente mapea.
• BasePath debe apuntar a esa rama, escrita sin un / inicial ('doconut', no '/doconut': el visor agrega la barra diagonal, y //doconut/... es una solicitud a otro host).
• DoconutOptions.ResourcesPath es la ruta del recurso incrustado.
• ResPath normalmente apunta a su subcarpeta images, también sin un / inicial ('doconut-res/images').
• ExtractHyperlinks debe estar habilitado en la configuración de formato del servidor antes de que showHyperlinks pueda mostrar algo.