ViewerConfig

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

C# 속성

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "/",                 // "/" = 사이트 루트(Web.config)의 DocImage.axd 핸들러
    ResPath = "doconut-res/images", // ResourcesPath 아래의 images 폴더, 선행 '/' 없음
    ShowHyperlinks = true
};
// viewer.RenderViewer("viewerEl", token, config)를 사용해 출력하십시오 - Viewer 참조를 보세요.

RenderViewer 로 ViewerConfig 내보내기

Viewer.RenderViewer(elementId, token, config) 은 ViewerConfig 을 위젯 초기화 스크립트로 변환합니다. 위의 속성 중 여섯 개—BasePath, ResPath, ShowThumbs, AutoLoad, PageZoom, 그리고 FitType—를 기록하고 나서 View(token) 를 호출합니다. 다른 속성들은 기록되지 않으며: MaxZoom, ShowHyperlinks, 줌 설정 또는 콜백의 경우, 아래 JavaScript 옵션으로 직접 위젯을 초기화하십시오. Viewer 에서 RenderViewer 를 확인하십시오.

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: '/',
    ResPath: 'doconut-res/images',
    onViewerReady: function () {},
    onError: function (message) { console.error('DocViewer:', message); }
});
</script>

콜백

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

공개 메서드 그룹

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

재시도 옵션

위젯은 또한 retryOn409와 그 백오프 설정(retryInitialDelayMs, retryBackoffFactor, retryMaxDelayMs, retryMaxAttempts, retryMaxTotalMs)을 허용합니다. 이는 백그라운드에서 페이지가 생성되는 배포에 사용됩니다. DocImage.axd는 요청 중에 모든 페이지를 렌더링하므로 retryOn409를 끈 상태로 두세요.

경로 체크리스트

• BasePath는 DocImage.axd 핸들러가 사이트 루트에 있을 때 '/'입니다 — Web.config의 핸들러에 있는 path 속성이 응답 위치를 결정합니다. 가상 디렉터리에서는 선행 / 없이 디렉터리 이름을 사용하세요 ('myapp', '/myapp'가 아니라: 뷰어가 슬래시를 추가하고, //myapp/...는 다른 호스트에 대한 요청입니다).
• DoconutOptions.ResourcesPath는 리소스 모듈이 임베디드 파일을 제공하는 위치입니다 (기본값은 /doconut-res).
• ResPath는 해당 images 하위 폴더를 대상으로 하며, 선행 / 없이도 사용합니다 ('doconut-res/images'). 이를 'doconut-res'에 지정하면 모든 아이콘이 404 오류가 발생하지만 문서는 여전히 렌더링됩니다.
• MVC에서는 routes.IgnoreRoute("doconut-res/{*pathInfo}")를 변경할 경우 ResourcesPath 뒤에 위치해야 합니다.
• ExtractHyperlinks는 showHyperlinks가 아무것도 표시하기 전에 서버 포맷 설정에서 활성화되어야 합니다.