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.

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 relatam nada no console do navegador. Se você está migrando uma página da biblioteca anterior, leia Callbacks e Path checklist 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 o 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 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 comportamentais importantes 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.

Cada um destes é uma opção no objeto de inicialização.

O visualizador anterior procurava funções globais cujos nomes eram derivados do id do contêiner — uma página com <div id="div_ctlDoc"> precisava apenas declarar function ctlDoc_OnViewerReady(). Essa busca foi removida. Passe a função explicitamente:

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

A busca antiga estava envolvida em um catch vazio, então nada era registrado. 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á embutido e controlado por showHyperlinks.

Grupos de métodos públicos

O arquivo JavaScript contém auxiliares internos também. 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á sendo renderizada

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 de nó único normal. Habilitá-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 caminhos

• DoconutOptions.MiddlewarePath deve descrever o ramo que você realmente mapeia.
• BasePath deve apontar para esse ramo, escrito sem uma barra 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 recursos incorporados.
• ResPath normalmente aponta para sua subpasta images, sem uma barra 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; não está correto aqui, e falha sem gerar erro.
• ExtractHyperlinks deve ser habilitado na configuração de formato do servidor antes que showHyperlinks possa exibir qualquer coisa.