ViewerConfig

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 debe mapear 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 Funciones de devolución de llamada y Lista de verificación de rutas antes de cualquier otra cosa.

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

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>

Retornos de llamada

Mantenga los retornos de llamada 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 desapareció. Pase la función explícitamente:

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... sus opciones existentes ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // se encontraba por nombre
    onViewerReady:    ctlDoc_OnViewerReady,     // se encontraba por nombre
    onCopy:           ctlDoc_Copy,              // era ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // era 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 existe un retorno de llamada para clic en enlaces — el manejo de hipervínculos está incorporado y controlado por showHyperlinks.

Grupos de métodos públicos

El archivo JavaScript también contiene 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.

Reintentar mientras una página distribuida aún se está renderizando

retryOn409 conserva su nombre histórico. Sirve para la producción asíncrona de páginas y vuelve a intentar la respuesta de disponibilidad 202 Accepted así como la señal anterior 409 Conflict. Cuando está habilitado, el widget realiza sondeos con estos valores predeterminados de JavaScript:

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

Habilítelo cuando las páginas se sirvan desde almacenamiento compartido con FirstPagePriority, donde las páginas posteriores responden legítimamente 202 Accepted hasta que se escriben. Un cliente que no reintente muestra mosaicos rotos para las 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 una barra inicial / ('doconut', no '/doconut': el visor agrega la barra, 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 eso establece BasePath: '/'.
• DoconutOptions.ResourcesPath es la ruta del recurso incrustado.
• ResPath normalmente apunta a su subcarpeta images, sin una barra 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; no es correcto aquí y falla sin generar un error.
• ExtractHyperlinks debe estar habilitado en la configuración del formato del servidor antes de que showHyperlinks pueda mostrar algo.