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 do lado do cliente nesta versão falham silenciosamente. As funções manipuladoras 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 Retornos de chamada e Lista de verificação 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",
    ResPath = "/doconut-res/images",
    ShowHyperlinks = true
};

Mapeamento C# → 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 possui padrões mais antigos que diferem da classe C#. Os valores a seguir vêm da implementação atual de docViewer.js.

Defina todos os valores importantes ao invés 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 desses é 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 declarar function ctlDoc_OnViewerReady(). Essa procura foi removida. Passe a função explicitamente:

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

A antiga procura estava envolvida em um catch vazio, portanto nada jamais 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á embutido e controlado por showHyperlinks.

Grupos de métodos públicos

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

Repetição enquanto uma página distribuída ainda está sendo renderizada

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

Deixe desativado para o visualizador normal de nó único. Habilitá‑lo não pode transformar uma renderização síncrona não suportada em assíncrona.

Habilite quando as páginas são servidas a partir de armazenamento compartilhado com FirstPagePriority, onde páginas posteriores legitimamente respondem 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. A aplicação de referência mantém a forma histórica de requisiçã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 — '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 estar habilitado na configuração de formato do servidor antes que showHyperlinks possa exibir qualquer coisa.