뷰어 옵션
createViewer 옵션과 메서드: 도구 모음 버튼, 확대·축소, 언어, 조회 조건, 찾기, 페이지 이동, 단축키입니다.
뷰어는 화면에 들어오는 페이지만 SVG로 그립니다. 단축키: PageUp/PageDown, Ctrl+Home/End, Ctrl+P(인쇄), Ctrl+휠(확대·축소).
| 이름 | 타입 | 설명 |
|---|---|---|
definition | ReportDefinition | 보고서 정의(JSON). |
data | ReportData | { rows: [...] }와 수식에서 쓰는 다른 값. |
fetchData | (params) => data | Promise | 파라미터로 데이터를 불러옵니다(처음과 조회할 때). |
params | object | 파라미터 초깃값(기본값보다 우선). |
lang | 'ko' | 'en' | 도구 모음 언어(기본 ko). |
toolbar | { pages, zoom, print, pdf, xlsx, xlsxData, csv, params } | 보여 줄 버튼(csv는 기본 꺼짐). |
zoom | number | 'width' | 'page' | 처음 배율(기본 폭 맞춤). |
paramsOpen | boolean | 처음부터 조회 조건 패널을 엽니다. |
fileName | string | 저장 파일 이름. |
licenseKey | string | 라이선스 키(또는 setLicenseKey 한 번). |
onOutput | (e) => boolean | void | Promise | 인쇄·저장 직전마다 호출. false를 돌려주면 취소. |
onReady | (e) => void | 보고서를 다 만들 때마다: { pages, rows, ms, params }. |
onParamsSubmit | (params) => false | params | void | 조회를 눌렀을 때: false면 그대로 머물고, 바꾼 조회 조건을 돌려주면 그 값으로 조회. |
onPageChange | (page, total) => void | 보고 있는 페이지가 바뀜(1부터). |
onError | (error, during) => void | 데이터('data'), 레이아웃('layout'), 인쇄·저장('output') 실패. |
pdfSecurity | { userPassword?, ownerPassword?, permissions? } | PDF 암호와 권한(AES-256). |
author | string | PDF 문서 정보의 작성자. |
뷰어 메서드
| 이름 | 타입 | 설명 |
|---|---|---|
refresh() | Promise<void> | 보고서를 다시 만듭니다. |
setData(data) / setParams(p) / setDefinition(def) | Promise<void> | 데이터·파라미터·정의를 바꾸고 다시 만듭니다. |
goTo(page) / setZoom(z) | void | 페이지 이동과 배율. |
print() | Promise<boolean> | 인쇄(onOutput이 막으면 false). |
report | Report | 아래의 Report 객체(toPdf, toXlsx…). |
destroy() | void | 뷰어를 없앱니다. |