[]
SpreadJSでは、JavaScriptライブラリの1つであるReactがサポートされます。Reactを使用すると、MVCフレームワークのビュー層を処理することで、Webアプリケーションおよびモバイルアプリケーションのユーザーインタフェースを構築できます。
Reactでは、ページをリロードせずにデータを変更できるだけでなく、再利用可能なコンポーネントや大規模なアプリケーションを作成できます。
メモ: SpreadJS は React バージョン16、17 および 18をサポートしています。
Reactを使用するには、次の手順を実行します。
Reactアプリを作成する
コマンドプロンプトウィンドウを開き、次のコマンドを入力します。コマンドを実行すると、ディレクトリ内の指定の場所にReactプロジェクトが作成されます。Reactプロジェクトの詳しい作成方法については、「Reactプロジェクトを始める」を参照してください。
npm install -g create-react-app
create-react-app quick-start
cd quick-start
npm start
Spread.Sheetsモジュールをインストールする
Spread.Sheets Reactモジュール、および日本語リソースを、npmからインストールします。
npm install @mescius/spread-sheets-react@xx.x.x
npm install @mescius/spread-sheets-resources-ja@xx.x.x
type=warning
'xx.x.x'の部分には製品のバージョンを指定してください。(例:17.1.10)
バージョンの指定を省略すると最新バージョンがインストールされますが、日本語版での動作保証は日本語版サイトで公開しているバージョンのみとなります。
製品のバージョンについては、製品購入時またはトライアル版でダウンロードした製品コンテンツに含まれるリリースノートをご確認ください。
スタイルをインポートする
index.jsファイルで、スタイルファイルをインポートします。
import'@mescius/spread-sheets/styles/gc.spread.sheets.excel2013white.css';
ReactアプリでSpread.Sheetsを使用する
src\App.jsファイルで、次のサンプルコードを使います。
import React from 'react';
import {SpreadSheets, Worksheet, Column} from '@mescius/spread-sheets-react';
import '@mescius/spread-sheets-resources-ja';
function App() {
const spreadBackColor = 'aliceblue';
const sheetName = 'Goods List';
const hostStyle =
{
width: '800px',
height: '600px'
};
const data = [{Name: 'Apple', Category: 'Fruit', Price: 1, 'Shopping Place': 'Wal-Mart'},{Name: 'Potato', Category: 'Fruit', Price: 2.01, 'Shopping Place': 'Other'},{Name: 'Tomato', Category: 'Vegetable', Price: 3.21, 'Shopping Place': 'Other'},{Name: 'Sandwich', Category: 'Food', Price: 2, 'Shopping Place': 'Wal-Mart'},{Name: 'Hamburger', Category: 'Food', Price: 2, 'Shopping Place': 'Wal-Mart'},{Name: 'Grape', Category: 'Fruit', Price: 4, 'Shopping Place': 'Sun Store'}];
const columnWidth = 100;
return (
<div>
<SpreadSheets backColor={spreadBackColor}hostStyle= {hostStyle}>
<Worksheet name={sheetName} dataSource={data}>
<Column dataField='Name' width={300}></Column>
<Column dataField='Category' width={columnWidth}></Column>
<Column dataField='Price' width={columnWidth} formatter="$#.00"></Column>
<Column dataField='Shopping Place' width={columnWidth}></Column>
</Worksheet>
</SpreadSheets>
</div>
);
}
export default App;
SpreadSheets、Worksheet、およびColumnは、タグ階層での基本要素です。他の要素は、それぞれ設定して使用します。主なタグ階層は次のとおりです。
<SpreadSheets>
<Worksheet>
<Column></Column>
...
</Worksheet>
...
</SpreadSheets>
以下の各トピックでは、さまざまな要素(ディレクティブ)について説明します。