ViewerConfig

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

이번 릴리스의 두 클라이언트 측 변경 사항은 조용히 실패합니다. 핸들러 함수는 옵션으로 전달되며 — 위젯은 더 이상 컨테이너 id에서 전역 함수 이름을 파생하지 않습니다 — 그리고 ResPath는 애플리케이션 루트가 아닌 리소스 접두사를 가리켜야 합니다. 두 경우 모두 서버는 정상적으로 작동하지만 브라우저 콘솔에 아무 것도 보고하지 않습니다. 이전 라이브러리에서 페이지를 이어받고 있다면, 먼저 콜백 및 경로 체크리스트를 읽으십시오.

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

콜백

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

이 중 모든 항목은 초기화 객체의 옵션입니다. 이전 뷰어는 컨테이너 ID에서 파생된 이름의 전역 함수를 찾아 사용했습니다 — <div id="div_ctlDoc">가 있는 페이지는 function ctlDoc_OnViewerReady()만 선언하면 되었습니다. 그 조회 방식은 사라졌습니다. 함수를 명시적으로 전달하세요:

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... your existing options ...
    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)
});

예전 조회는 빈 catch로 감싸져 있었기 때문에 아무것도 보고되지 않았습니다. 이번 릴리스에서는 함수가 전혀 실행되지 않으며, 일반적인 증상은 onViewerReady가 숨겨야 할 스피너가 멈추지 않는 바쁜 스피너가 계속 표시되는 것입니다. 그 뒤의 문서는 정상적으로 렌더링됩니다.

링크 클릭 콜백은 없습니다 — 하이퍼링크 처리는 내장되어 있으며 showHyperlinks에 의해 제어됩니다.

공개 메서드 그룹

JavaScript 파일에는 내부 헬퍼도 포함되어 있습니다. 여기 또는 기능 가이드에 문서화된 레퍼런스 UI에서 사용되는 메서드만을 안정적인 통합 지점으로 간주하십시오.

분산 페이지가 아직 렌더링 중일 때 재시도

retryOn409는 기존 이름을 유지합니다. 이는 비동기 페이지 생성에 사용되며 현재 202 Accepted 준비 응답과 이전 409 Conflict 신호를 모두 재시도합니다. 활성화하면 위젯이 다음 JavaScript 기본값으로 폴링합니다:

일반 단일 노드 뷰어에서는 비활성화 상태를 유지하십시오. 이를 활성화해도 지원되지 않는 동기 렌더링을 비동기로 만들 수 없습니다.

FirstPagePriority가 설정된 공유 스토리지에서 페이지가 제공되는 경우에만 활성화하십시오. 이 경우 이후 페이지는 실제로 202 Accepted를 반환하면서 기록될 때까지 대기합니다. 재시도하지 않는 클라이언트는 아직 렌더링 중인 페이지에 대해 깨진 타일을 표시합니다 — 자세한 내용은 분산 배포 를 참조하십시오.

경로 체크리스트

• DoconutOptions.MiddlewarePath는 실제로 매핑하는 브랜치를 설명해야 합니다.
• BasePath는 해당 브랜치를 가리켜야 하며, 앞에 / 없이 작성합니다 ('doconut', '/doconut' 아님: 뷰어가 슬래시를 추가하고 //doconut/...는 다른 호스트에 대한 요청이 됩니다). 레퍼런스 애플리케이션은 MapWhen 브랜치에서 기존 DocImage.axd 요청 형태를 유지하므로 BasePath: '/' 로 설정합니다.
• DoconutOptions.ResourcesPath는 임베디드 리소스 라우트입니다.
• ResPath는 일반적으로 images 하위 폴더를 가리키며, 앞에 / 없이 지정합니다 — 기본 접두사가 붙은 'doconut-res/images' 와 같이. 이전 라이브러리에서는 빈 ResPath가 애플리케이션 루트에서 리소스를 가져와 올바른 설정이었지만, 여기서는 올바르지 않으며 오류 없이 실패합니다.
• ExtractHyperlinks는 showHyperlinks가 내용을 표시하기 전에 서버 포맷 구성에서 활성화되어야 합니다.