ViewerConfig

ViewerConfig (namespace Doconut) descreve a aparência e o comportamento do visualizador no navegador. Não afeta a qualidade de renderização do documento; use uma configuração de formato para isso. A classe C# e o widget JavaScript de longa data têm padrões diferentes, portanto mapeie os valores explicitamente.

Propriedades C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "doconut",           // sem barra inicial '/': o visualizador a adiciona ("/doconut" se tornaria //doconut, outro host)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

Mapeamento de C# para JavaScript

Não passe um ViewerConfig serializado diretamente para docViewer(...). A maioria das chaves do widget usa camelCase, enquanto três chaves estabelecidas de caminho/ajuste usam PascalCase.

Padrões de JavaScript

O widget tem padrões mais antigos que diferem da classe C#. Os valores a seguir provêm da implementação atual do docViewer.js.

Defina todos os valores importantes de comportamento em vez de depender de qualquer conjunto de padrões:

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

Callbacks

Mantenha os callbacks rápidos; envie telemetria de forma assíncrona e não bloqueie a renderização da página.

Grupos de métodos públicos

O arquivo JavaScript também contém auxiliares internos. Considere apenas os métodos usados pela UI de referência e documentados aqui ou nos guias de recursos como pontos de integração estáveis.

Repetir enquanto uma página distribuída ainda está renderizando

retryOn409 mantém seu nome histórico. É para produção assíncrona de páginas e repete a resposta de prontidão atual 202 Accepted assim como o sinal mais antigo 409 Conflict. Quando habilitado, o widget faz polling com esses padrões JavaScript:

Deixe desativado para o visualizador normal. Habilitá-lo não pode tornar uma renderização síncrona não suportada assíncrona.

Lista de verificação de caminho

• DoconutOptions.MiddlewarePath deve descrever o branch que você realmente mapeia.
• BasePath deve apontar para esse branch, escrito sem uma barra inicial / ('doconut', não '/doconut': o visualizador adiciona a barra, e //doconut/... é uma requisição para outro host).
• DoconutOptions.ResourcesPath é a rota de recurso incorporado.
• ResPath normalmente aponta para sua subpasta images, também sem uma barra inicial / ('doconut-res/images').
• ExtractHyperlinks deve estar habilitado na configuração de formato do servidor antes que showHyperlinks possa exibir qualquer coisa.