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 widget JavaScript de larga data tienen valores predeterminados diferentes, así que mapee los valores 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 desde la biblioteca anterior, lea Llamadas de retorno 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",           // 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>

Retrollamadas

Mantenga las retrollamadas rápidas; envíe telemetría de forma asíncrona y no bloquee la renderización de la página.

Cada una de estas 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,      // se encontró por nombre
    onViewerReady:    ctlDoc_OnViewerReady,     // se encontró por nombre
    onCopy:           ctlDoc_Copy,              // fue ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // fue ctlDoc_AutoLoadStatus(page)
});

La búsqueda antigua 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 indicador de carga que nunca se detiene, porque el controlador que lo ocultaba era onViewerReady. El documento detrás de él se está renderizando correctamente.

No hay una retrollamada de clic en enlace — el manejo de hipervínculos está incorporado y es controlado por showHyperlinks.

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 mientras una página distribuida aún se está renderizando

retryOn409 conserva su nombre histórico. Es para la producción de páginas 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 consulta con estos valores predeterminados de JavaScript:

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

Habilítelo cuando las páginas se sirven desde almacenamiento compartido con FirstPagePriority, donde las páginas posteriores responden legítimamente 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 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). La aplicación de referencia mantiene la forma histórica de solicitud DocImage.axd en una rama MapWhen y por lo tanto establece BasePath: '/'.
• DoconutOptions.ResourcesPath es la ruta de recurso incrustada.
• ResPath normalmente apunta a su subcarpeta images, sin un / inicial — '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; aquí no es correcto, y falla sin un error.
• ExtractHyperlinks debe estar habilitado en la configuración de formato del servidor antes de que showHyperlinks pueda mostrar algo.