ViewerConfig

ViewerConfig (namespace Doconut) descreve a aparência e o comportamento do visualizador do 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.

Duas alterações no lado do cliente nesta versão falham silenciosamente. Funções de manipulador são passadas como opções — o widget não deriva mais nomes de funções globais a partir do id do contêiner — e ResPath deve apontar para o prefixo de recursos em vez da raiz da aplicação. Ambas deixam o servidor funcionando perfeitamente e não reportam nada no console do navegador. Se você está avançando uma página da biblioteca anterior, leia Callbacks e Checklist de caminho antes de qualquer outra coisa.

Propriedades C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "doconut",           // sem '/' inicial: o visualizador adiciona isso ("/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 são camelCase, enquanto três chaves estabelecidas de caminho/ajuste são PascalCase.

Padrões do JavaScript

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

Defina todos os valores importantes de comportamento em vez de confiar em 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>

Retornos de chamada

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

Cada um destes é uma opção no objeto de inicialização. O visualizador anterior buscava funções globais cujos nomes eram derivados do id do contêiner — uma página com <div id="div_ctlDoc"> só precisava declarar function ctlDoc_OnViewerReady(). Essa busca desapareceu. Passe a função explicitamente:

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... suas opções existentes ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // foi encontrado por nome
    onViewerReady:    ctlDoc_OnViewerReady,     // foi encontrado por nome
    onCopy:           ctlDoc_Copy,              // foi ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // foi ctlDoc_AutoLoadStatus(page)
});

A busca antiga estava encapsulada em um catch vazio, portanto nada foi relatado. Nesta versão, as funções simplesmente nunca são executadas: o sintoma usual é um spinner de carregamento que nunca para, porque o manipulador que o ocultava era onViewerReady. O documento por trás dele está sendo renderizado corretamente.

Não há callback de clique em link — o tratamento de hiperlinks está incorporado e é controlado por showHyperlinks.

Grupos de métodos públicos

O arquivo JavaScript também contém auxiliares internos. Considere apenas os métodos usados pela interface 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. Ele serve 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 ativado, o widget faz sondagens com esses padrões JavaScript:

Deixe-o desativado para o visualizador de nó único padrão. Ativá-lo não pode tornar uma renderização síncrona não suportada assíncrona.

Ative-o quando as páginas são servidas a partir de armazenamento compartilhado com FirstPagePriority, onde páginas posteriores respondem legitimamente 202 Accepted até serem gravadas. Um cliente que não repete mostra blocos quebrados para páginas ainda em renderização — veja Implantações Distribuídas.

Lista de verificação de caminho

• DoconutOptions.MiddlewarePath deve descrever o ramo que você realmente mapeia.
• BasePath deve apontar para esse ramo, escrito sem um / inicial ('doconut', não '/doconut': o visualizador adiciona a barra, e //doconut/... é uma solicitação para outro host). O aplicativo de referência mantém a forma histórica de solicitação DocImage.axd em um ramo MapWhen e, portanto, define BasePath: '/'.
• DoconutOptions.ResourcesPath é a rota de recurso incorporado.
• ResPath normalmente aponta para sua subpasta images, sem um / inicial — 'doconut-res/images' com o prefixo padrão. Um ResPath vazio era correto na biblioteca anterior, onde os recursos vinham da raiz da aplicação; aqui não está correto, e falha sem gerar erro.
• ExtractHyperlinks deve ser ativado na configuração de formato do servidor antes que showHyperlinks possa exibir qualquer coisa.