React용 ActiveReportsJS 보고서 뷰어 래퍼:
이 페이지에서는 React용 ActiveReportsJS 보고서 뷰어 래퍼에 대해 자세히 설명합니다. React 응용 프로그램에 래퍼 통합을 위한 간단한 가이드는 시작하기 자습서를 확인하십시오.
ActiveReportsJS React NPM 패키지
@mescius/activereportsjs-react npm 패키지를 통해 React용 ActiveReportsJS 보고서 뷰어 래퍼 컴포넌트가 포함된 라이브러리를 배포합니다. 기본 @mescius/activereportsjs 패키지는 핵심 기능을 제공합니다.
ActiveReportsJS React 뷰어 컴포넌트
ActiveReportsJS React 뷰어 컴포넌트는 JSX(TSX) 파일로 내보내 컴포넌트의 렌더링 트리에 포함할 수 있습니다. 예를 들어 다음과 같습니다.
import { Viewer as ReportViewer } from "@mescius/activereportsjs-react";
function App() {
return (
<div>
<ReportViewer />
</div>
);
}뷰어 컴포넌트는 다음 속성을 허용합니다.
속성 | 유형 | 기본값 | 설명 |
|---|---|---|---|
availableExports | 문자열의 배열 | 뷰어 UI에서 사용할 수 있는 내보내기 목록을 설정합니다. 자세한 내용은 내보내기 페이지를 참조하십시오. | |
mouseMode | 'Pan' | 'Selection' | 'Pan' |
renderMode | 'Galley' | 'Paginated' | 'Paginated' |
viewMode | 'Continuous' | 'SinglePage' | 'Continuous' |
zoom | 'FitWidth' | 'FitPage' | number |
fullscreen | boolean | false | 뷰어 컴포넌트가 콘텐츠를 전체 화면 모드에서 표시해야 하는지 여부를 나타냅니다. |
toolbarVisible | boolean | true | 뷰어 컴포넌트의 도구 모음 표시 여부를 나타냅니다. |
sidebarVisible | boolean | true | 뷰어 컴포넌트의 세로 막대 표시 여부를 나타냅니다. |
panelsLayout | 'sidebar' | 'toolbar' | 'toolbar' |
parameterPanelLocation | 'default' | 'top' | 'bottom' |
toolbarLayout | Object | 사용 가능한 도구 모음 항목의 목록을 설정합니다. 자세한 내용은 사용자 정의 페이지를 참조하십시오. | |
language | string | 뷰어의 UI 언어를 설정합니다. 자세한 내용은 지역화 페이지를 참조하십시오. | |
exportsSettings | object | 내보내기 설정을 지정합니다. 자세한 내용은 내보내기 설정 페이지를 참조하십시오. | |
report | Object | 뷰어 컴포넌트에서 로드할 보고서를 설정합니다. 자세한 내용은 보고서 로드 섹션을 참조하십시오. | |
reportLoaded | (args: ReportLoadEventArgs)=>void | 보고서가 로드되면 렌더링이 시작되기 전에 발생하는 이벤트의 처리기를 설정합니다. | |
documentLoaded | (args: DocumentLoadEventArgs)=>void | 보고서 렌더링이 완료되면 발생하는 이벤트의 처리기를 설정합니다. | |
errorHandler | ()=> void | 보고서 렌더링이 오류를 일으키는 경우 발생하는 이벤트의 처리기를 설정합니다. | |
showParametersOnOpen | 'auto'|'always' | 'auto' |
|
이러한 입력 속성을 동적 값에 바인딩하여 뷰어 컴포넌트의 기본 UI를 완전히 덮어쓸 수 있습니다. 자세한 내용은 사용자 정의 페이지를 참조하십시오.
또한 부모 컴포넌트가 뷰어 컴포넌트에 대한 ref를 만든 다음 해당 Viewer 속성을 사용하여 뷰어 클래스 인스턴스의 메서드 및 속성에 액세스할 수 있습니다. 예를 들어 다음과 같습니다.
import { Viewer as ReportViewer } from "@mescius/activereportsjs-react";
function App() {
const viewerRef = React.createRef();
const btnClick = function () {
viewerRef.current.Viewer.toggleFullScreen();
};
return (
<div id="viewer-host">
<button type="button" onClick={btnClick}>
Full Screen
</button>
<ReportViewer ref={viewerRef} />
</div>
);
}