⚡ アーカイブガイド: モダン React (18 & 19) が利用可能です
このチュートリアルは、従来の GoldenLayout 構成によるレガシーな React 15/16
の直接マウント方式を記録したものです。React 18 または 19、フック、および React Portals (
createPortal)
を使用するモダンなアプリケーションについては、更新されたガイドを参照してください:
モダン React 18 & 19 統合チュートリアル →
基本から順に見ていきましょう:
基本構成要素 (Building Blocks)
Strelit Layout のレイアウトは、行 (Rows)、列 (Columns)、スタック (Stacks) の 3 つの構成要素から作られます

行 (Rows) はコンポーネントを X 軸に沿って水平方向に配置します

列 (Columns) はコンポーネントを Y 軸に沿って垂直方向に配置します

スタック (Stacks) はコンポーネントを Z 軸に沿ってタブとして重ねて配置します
これら 3 つの構成要素は、互いに無制限に入れ子(ネスト)できます。

設定からモデルへ
HTML や JavaScript での DOM 操作の経験があれば、Strelit Layout の動作原理をすぐに理解できます。StrelitLayout は次のような JSON 設定から生成されます:
var myLayout = new StrelitLayout({
content: [
{
type: 'row',
content: [
{
type: 'react-component',
component: 'test-component',
props: { label: 'A' },
},
{
type: 'column',
content: [
{
type: 'react-component',
component: 'test-component',
props: { label: 'B' },
},
{
type: 'react-component',
component: 'test-component',
props: { label: 'C' },
},
],
},
],
},
],
});
この JSON 設定が解析され、レイアウトエンジンがオブジェクトツリーを構築します。このオブジェクトツリーは対話可能であり、JavaScript を使用して動的に操作できます:
// 'someId' を持つ要素を新しいウィンドウで開く
myLayout.root.getItemsById('someId')[0].popout();
// レイアウトに別のコンポーネントを追加
myLayout.root.contentItems[0].addChild({
type: 'react-component',
component: 'testComponent',
props: { label: 'X' },
});
コンポーネント
Strelit Layout は任意の React コンポーネントと連動します。registerComponent()
で登録します:
var TestComponent = React.createClass({
render: function () {
return <h1>{this.props.label}</h1>;
},
});
myLayout.registerComponent('testComponent', TestComponent);
// すべてのコンポーネントが登録されたら初期化
myLayout.init();
レイアウトの作成に必要なのはこれだけです。StrelitLayout からアクセスできるよう、jQuery、React、ReactDOM が適切にインクルードされていることを確認してください。
対話型サンプル: React のクイックスタート
CodePen 上で完全なレイアウト実装を確認、フォーク、テストできます:
Container と EventHub
基本を押さえたところで、より高度な機能を見ていきましょう。
Container はコンポーネントが配置されるパネルを表します。
setTitle() や close() などの便利なメソッドを多数備え、
resize などのイベントを発行します。コンポーネントが配置されているコンテナには、
glContainer
という特別なプロパティを通じてアクセスできます。コンテナを介してコンポーネントの上位にあるレイアウトツリーにもアクセス可能です。たとえば、コンポーネント全体を新しいウィンドウに移動するには次のように呼び出します:
this.props.glContainer.parent.popout();
コンポーネント間の通信は常に課題となりますが、複数のウィンドウや画面にコンポーネントが分散している場合はさらに複雑になります。そのため、Strelit
Layout には EventHub
が搭載されています。これはすべてのウィンドウに共通するグローバルな EventEmitter
であり、ウィンドウをまたいだコンポーネント間通信に使用できます。eventHub には
glEventHub
というプロパティを通じてアクセスできます。すべてのウィンドウに対してイベントを発行するには次のように呼び出します:
this.props.glEventHub.emit('something-happend', { some: 'data' });
これらの機能を活用した ReactJS の実装サンプルです(コンポーネントの片方または両方をポップアウトして、ウィンドウ間でも対話できることを確認してください):
対話型サンプル: React との高度な連携
CodePen 上で完全なレイアウト実装を確認、フォーク、テストできます: