Configuración del Visor

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 widget JavaScript de larga data tienen valores predeterminados diferentes, por lo que los valores deben mapearse explícitamente.

Dos cambios del lado del cliente en esta versión fallan silenciosamente. Las funciones manejadoras se pasan como opciones — el widget ya no deriva nombres de funciones globales del id del contenedor — y ResPath debe apuntar al prefijo de recursos en lugar de la raíz de la aplicación. Ambos dejan el servidor funcionando perfectamente y no informan nada en la consola del navegador. Si está trasladando una página de la biblioteca anterior, lea Devoluciones de llamada y Lista de verificación de rutas antes que nada.

Propiedades de C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "/doconut",
    ResPath = "/doconut-res/images",
    ShowHyperlinks = true
};

Mapeo de C# a JavaScript

No pase un ViewerConfig directamente serializado 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 confiar en 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>

Devoluciones de llamada

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

Cada uno de estos es una opción en el objeto de inicialización. El visor anterior buscaba funciones globales cuyos nombres derivaba del id del contenedor — una página con <div id="div_ctlDoc"> solo tenía que declarar function ctlDoc_OnViewerReady(). Esa búsqueda ha desaparecido. Pase la función explícitamente:

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... sus opciones existentes ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // antes se encontraba por nombre
    onViewerReady:    ctlDoc_OnViewerReady,     // antes se encontraba por nombre
    onCopy:           ctlDoc_Copy,              // antes era ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // antes era ctlDoc_AutoLoadStatus(page)
});

La búsqueda anterior estaba envuelta en un catch vacío, por lo que nunca se informó nada. En esta versión las funciones simplemente nunca se ejecutan: el síntoma habitual es un spinner de carga que nunca se detiene, porque el manejador que lo ocultaba era onViewerReady. El documento detrás de él se está renderizando correctamente.

No existe un callback para clics en enlaces — el manejo de hipervínculos está integrado y es impulsado por showHyperlinks.

Grupos de métodos públicos

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

Reintento mientras una página distribuida sigue renderizándose

retryOn409 conserva su nombre histórico. Sirve para producción de página asíncrona y reintenta la respuesta de disponibilidad actual 202 Accepted así como la señal más antigua 409 Conflict. Cuando está habilitado, el widget sondea con estos valores predeterminados de JavaScript:

Déjelo deshabilitado para el visor normal de nodo único. Habilitarlo no puede convertir un renderizado sincrónico no soportado en asíncrono.

Habilítelo cuando las páginas se sirvan desde almacenamiento compartido con FirstPagePriority, donde páginas posteriores legítimamente responden 202 Accepted hasta que se escriben. Un cliente que no reintenta muestra mosaicos rotos para páginas que aún se están renderizando — vea Despliegues distribuidos.

Lista de verificación de rutas

• DoconutOptions.MiddlewarePath debe describir la rama que realmente asigna.
• BasePath debe apuntar a esa rama. La aplicación de referencia mantiene la forma histórica de solicitud DocImage.axd en una rama MapWhen y por eso establece BasePath: '/'.
• DoconutOptions.ResourcesPath es la ruta del recurso incrustado.
• ResPath normalmente apunta a su subcarpeta /images — 'doconut-res/images' con el prefijo predeterminado. Un ResPath vacío era correcto en la biblioteca anterior, donde los recursos provenían de la raíz de la aplicación; no es correcto aquí y falla sin generar error.
• ExtractHyperlinks debe estar habilitado en la configuración de formato del servidor antes de que showHyperlinks pueda mostrar algo.