ViewerConfig

ViewerConfig (namespace Doconut)는 브라우저 뷰어의 외관과 동작을 설명합니다. 문서 렌더링 품질에는 영향을 주지 않으며, 이를 위해서는 포맷 구성을 사용하십시오. C# 클래스와 레거시 JavaScript 플러그인은 기본값이 다르므로 값을 명시적으로 매핑해야 합니다.

C# 속성

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "doconut",           // 선행 '/' 없음: 뷰어가 이를 추가합니다 ("/doconut"은 //doconut가 되어 다른 호스트가 됩니다)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

C#에서 JavaScript로 매핑

직접 직렬화된 ViewerConfig를 docViewer(...)에 전달하지 마십시오. 대부분의 위젯 키는 camelCase이며, 세 개의 경로/맞춤 키는 PascalCase입니다.

JavaScript 기본값

위젯은 C# 클래스와 다른 오래된 기본값을 가지고 있습니다. 다음 값들은 현재 docViewer.js 구현에서 가져온 것입니다.

동작에 중요한 모든 값을 명시적으로 설정하고 기본값에 의존하지 마십시오:

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

콜백

콜백을 빠르게 유지하고, 텔레메트리를 비동기적으로 전송하며 페이지 렌더링을 차단하지 마세요.

공개 메서드 그룹

JavaScript 파일에는 내부 헬퍼도 포함됩니다. 여기 또는 기능 가이드에 문서화된 레퍼런스 UI에서 사용되는 메서드만 안정적인 통합 포인트로 간주하세요.

HTTP 409 후 재시도

retryOn409는 비동기 페이지 생성에 사용됩니다. 활성화되면 위젯이 다음 JavaScript 기본값으로 폴링합니다:

일반 뷰어에서는 비활성화 상태로 두세요. 이를 활성화해도 지원되지 않는 동기 렌더링을 비동기로 만들 수 없습니다.

경로 체크리스트

• DoconutOptions.MiddlewarePath는 실제로 매핑하는 브랜치를 설명해야 합니다.
• BasePath는 해당 브랜치를 대상으로 해야 하며, 앞에 / 없이 작성합니다 ('doconut', '/doconut'가 아니라: 뷰어가 슬래시를 추가하고 //doconut/...는 다른 호스트에 대한 요청입니다).
• DoconutOptions.ResourcesPath는 임베디드 리소스 경로입니다.
• ResPath는 일반적으로 images 하위 폴더를 대상으로 하며, 앞에 / 없이 ('doconut-res/images') 작성합니다.
• ExtractHyperlinks는 showHyperlinks가 무언가를 표시하기 전에 서버 포맷 설정에서 활성화되어야 합니다.