FreeReportv0.9.0English

뷰어 옵션

createViewer 옵션과 메서드: 도구 모음 버튼, 확대·축소, 언어, 조회 조건, 찾기, 페이지 이동, 단축키입니다.

뷰어는 화면에 들어오는 페이지만 SVG로 그립니다. 단축키: PageUp/PageDown, Ctrl+Home/End, Ctrl+P(인쇄), Ctrl+휠(확대·축소).

이름타입설명
definitionReportDefinition보고서 정의(JSON).
dataReportData{ rows: [...] }와 수식에서 쓰는 다른 값.
fetchData(params) => data | Promise파라미터로 데이터를 불러옵니다(처음과 조회할 때).
paramsobject파라미터 초깃값(기본값보다 우선).
lang'ko' | 'en'도구 모음 언어(기본 ko).
toolbar{ pages, zoom, print, pdf, xlsx, xlsxData, csv, params }보여 줄 버튼(csv는 기본 꺼짐).
zoomnumber | 'width' | 'page'처음 배율(기본 폭 맞춤).
paramsOpenboolean처음부터 조회 조건 패널을 엽니다.
fileNamestring저장 파일 이름.
licenseKeystring라이선스 키(또는 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).
authorstringPDF 문서 정보의 작성자.

뷰어 메서드

이름타입설명
refresh()Promise<void>보고서를 다시 만듭니다.
setData(data) / setParams(p) / setDefinition(def)Promise<void>데이터·파라미터·정의를 바꾸고 다시 만듭니다.
goTo(page) / setZoom(z)void페이지 이동과 배율.
print()Promise<boolean>인쇄(onOutput이 막으면 false).
reportReport아래의 Report 객체(toPdf, toXlsx…).
destroy()void뷰어를 없앱니다.