맞춤 테마

앱에 맞게 뷰어 스타일링

뷰어는 내장 리소스(viewer.css)와 각 기능별 스타일시트(searchBar.css 및 annotationBar.css)를 통해 제공되는 중립적이고 Bootstrap 기반의 외관을 가지고 있습니다. 테마 적용은 세 단계로 이루어지며, 가장 얕은 단계부터 선택하면 됩니다.

레벨 1 — 크롬 구성

많은 "테마 지정"은 실제로 설정에 불과합니다:

  • ViewerConfig.ShowThumbs = false — 썸네일 패널이 없습니다.
  • ViewerConfig.FitType = "height" | "width" — 페이지가 뷰포트를 채우는 방식.
  • 선택적 CssConfig/ScriptConfig 번들 — 호스트가 사용하는 크롬만 유지합니다.

레벨 2 — CSS 재정의

Viewer.ReferenceCss() 은 일반 <link> 태그를 출력합니다; 그 후에 로드하는 모든 것이 cascade에서 우선합니다. 자체 스타일시트에서 뷰어의 크기와 프레임을 지정하세요:

css
/* ReferenceCss() 이후에 로드되는 스타일시트 */

/* 당신이 소유한 두 개의 컨테이너 */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }

/* 위젯 페이지 카드 */
.docPage { max-width: none; }

호스트 페이지는 외부 레이아웃을 완전히 제어합니다 — 위젯은 제공한 #divDocViewer / #div_ctlDoc (Quick Start의 표준 컨테이너 쌍) 안에 렌더링됩니다.

두 가지 실용적인 규칙:

  • Bootstrap을 두 번 로드하지 마세요. 앱에 이미 Bootstrap이 포함되어 있다면 IncludeBootstrapCss/IncludeBootstrap 을 건너뛰고 위젯이 여러분의 Bootstrap을 상속하도록 하세요 — 이것만으로도 뷰어가 앱에 자연스럽게 보이게 됩니다.
  • 사용하는 번들만 포함하세요. 모든 CssConfig/ScriptConfig 플래그는 선택적으로 활성화됩니다; 번들이 적을수록 싸워야 할 스타일도 적어집니다.

레벨 3 — 자체 툴바 만들기

완전한 브랜드 경험을 위해, 위젯을 자체 UI에서 제어하세요. 이러한 툴바는 호스트 마크업과 앱 전용 헬퍼로 구성되며, 내장 SDK 리본이 아닙니다. 초기화 시 반환되는 docViewer 인스턴스는 여러분의 API 인터페이스이며, 자체 엔드포인트와 함께 사용됩니다 — 여기서는 뷰어 작동 방식에서의 ViewerApi/Open 액션을 예시로 보여줍니다:

html
<div id="toolbar">
    <button id="btnOpen">Open</button>
    <button id="btnPrev">‹</button>
    <button id="btnNext">›</button>
    <!-- 당신의 디자인 시스템, 당신의 아이콘 -->
</div>
<div id="divDocViewer"><div id="div_ctlDoc"></div></div>

<script>
    const objViewer = $('#div_ctlDoc').docViewer({
        showThumbs: true,
        autoLoad:   false,
        BasePath:   '/',
        ResPath:    'doconut-res/images',
        onViewerReady: () => { /* 당신의 버튼을 활성화 */ },
        onError: (msg) => console.error('DocViewer:', msg)
    });

    document.getElementById('btnOpen').addEventListener('click', async () => {
        const resp  = await fetch('/ViewerApi/Open?fileName=Sample.pdf', { method: 'POST' });
        const token = await resp.text();
        objViewer.View(token);
    });
</script>

Search와 Annotation은 다릅니다: 선택적 Ribbon 구성 요소가 SDK(IncludeSearchBar, IncludeAnnotationBar)에 내장되어 자체 DOM을 생성합니다. 이를 커스텀 Viewer 툴바와 함께 사용할 수 있거나 건너뛰고 기본 위젯 API를 직접 호출할 수 있습니다. 전체 통합 순서는 빠른 시작 을 참고하세요.

다크 모드 및 RTL

위젯은 다크 테마를 제공하지 않으며, 배경과 테두리에 적용되는 다크 모드 클래스(예: .dark #divDocViewer { … })를 대상으로 하는 레벨 2 재정의만으로 대부분의 요구를 충족할 수 있습니다. 페이지 콘텐츠 자체가 이미지 형태로 렌더링되기 때문입니다. RTL 호스트의 경우, 뷰어는 RTL 레이아웃 안에서 정상적으로 동작하므로 자체 툴바도 RTL을 인식하도록 유지하세요.

하지 말아야 할 일

내장 스타일시트를 포크하거나 수정하지 마세요: 이 파일들은 패키지에 포함되어 있으며 업데이트 시마다 교체됩니다. 자체 스타일시트에서의 재정의는 업그레이드 후에도 유지되지만, viewer.css 를 수정하면 그 변경 내용은 사라집니다.

이 페이지가 도움이 되었나요?