このトピックではReactフレームワークでデザイナを使用する際のReact対応パッケージについて説明します。React対応パッケージからデザイナをWebアプリケーションに組み込む方法については、クイックスタート > Webデザイナコンポーネントの使用 > Reactを参照してください。
React対応パッケージはnpmを利用してインストールすることができます。@grapecity/activereports-reactパッケージをプロジェクトにインストールすると、デザイナを使用できます。 React対応パッケージは@grapecity/activereportsパッケージに依存しており、React対応パッケージをインストールすると同時にインストールされます。
Reactのデザイナは、次のようにJSX(TSX)ファイルにインポートして、コンポーネントのレンダリングツリーに含めることができます。
import { Designer } from "@grapecity/activereports-react";
function App() {
return (
<div>
<Designer />
</div>
);
}
デザイナには、次のプロパティが用意されています。
| プロパティ | 設定値 | 説明 |
|---|---|---|
| hotkeysEnabled | boolean | ファイルを開くおよび保存するショートカットを有効にするかどうかを示します。 |
| language | string | デザイナコンポーネントの表示言語を設定します。詳細については、「表示言語を設定する」を参照してください。 |
| fontSet | "default" | "registered" | "all" | 利用可能なフォントを示します。 |
| dataSources | DataSourceTemplatesの配列 | 事前定義されたデータソースとデータセットを設定します。 |
| reportList | Report Resource Info itemsの配列 | SubReportコントロールの[レポート名前]プロパティを設定します。 |
| imageList | Image Resource Info itemsの配列 | Imageコントロールの事前定義画像を設定します。 |
| onCreate | onCreate関数 | デザイナのツールバーに[新規作成]ボタンを追加し、対応するクリックハンドラを設定します。 |
| onOpen | onOpen関数 | ツールバーに[開く]ボタンを追加し、対応するクリックハンドラを設定します。 |
| onRender | onRender関数 | ツールバーに[プレビュー]ボタンを追加し、対応するクリックハンドラを設定します。 |
| onSave | onSave関数 | ツールバーに[保存]ボタンを追加し、対応するクリックハンドラを設定します。 |
| onSaveAs | onSaveAs関数 | ツールバーに[名前を付けて保存]ボタンを追加し、対応するクリックハンドラを設定します。 |
| onOpenFileMenu | onOpenFileMenu関数 | ツールバーに[ファイル]メニューを追加し、対応するクリックハンドラを設定します。 |
| report | レポートオブジェクト | 指定されたレポートをデザイナに読み込みます。 |
また、親コンポーネントは、デザイナ参照を作成して、Designer クラスのgetReport、setReport、およびprocessCommandメソッドを使用できます。
import { Designer } from "@grapecity/activereports-react";
function App() {
const designerRef = React.createRef();
const btnClick = function () {
designerRef.current.setReport({id: "report.rdlx-json"});
};
return (
<div id="designer-host">
<button type="button" onClick={btnClick}>
Open Report
</button>
<Designer ref={designerRef} />
</div>
);
}