モダンな React(v18 & v19)において、マルチウィンドウドッキングの最も堅牢で慣用的なパターンは、
React Portals (createPortal)
の活用です。これにより、パネルがスタック間でドラッグされたり、補助ウィンドウにポップアウトされたりしても、コンポーネントがアンマウント・再マウントされることなく、内部状態、React Context、およびイベントバブリングが完全に保持されます。
1. インストール
npm から Strelit UI Kit をインストールします:
npm install strelit-ui-kit
2. React Portal ドッキングパターン
レイアウトエンジンに DOM ライフサイクルを命令的に管理させる代わりに、コンテナ DOM 要素を React に引き渡す汎用コンポーネントファクトリを登録します。React は仮想 DOM コンポーネントをこれらのコンテナにシームレスに投影します:
import React, { useState, useRef, useLayoutEffect } from 'react';
import { createPortal } from 'react-dom';
import { StrelitLayout, LayoutConfig, ComponentContainer } from 'strelit-ui-kit';
import 'strelit-ui-kit/dist/css/strelit-base.css';
import 'strelit-ui-kit/dist/css/themes/strelit-dark-theme.css';
interface PortalMount {
id: string;
element: HTMLElement;
component: React.ReactNode;
}
export function DockingWorkspace() {
const containerRef = useRef<HTMLDivElement>(null);
const layoutRef = useRef<StrelitLayout | null>(null);
const [portals, setPortals] = useState<PortalMount[]>([]);
useLayoutEffect(() => {
if (!containerRef.current) return;
const config: LayoutConfig = {
root: {
type: 'row',
content: [
{
type: 'component',
componentType: 'portalHost',
title: 'テレメトリインスペクター',
componentState: { key: 'telemetry' }
},
{
type: 'component',
componentType: 'portalHost',
title: 'イベントログストリーム',
componentState: { key: 'logs' }
}
]
}
};
// 1. マウントする DOM 要素上で StrelitLayout を初期化
const layout = new StrelitLayout(containerRef.current);
// 2. コンテナ要素を React に渡す汎用ホストコンポーネントを登録
layout.registerComponentFactoryFunction('portalHost', (container: ComponentContainer, itemConfig) => {
const el = container.element;
const state = (itemConfig.componentState as { key: string }) || { key: 'unknown' };
const key = state.key;
const component = key === 'telemetry'
? <TelemetryViewer />
: <LogStreamViewer />;
setPortals(prev => [...prev, { id: key, element: el, component }]);
container.on('destroy', () => {
setPortals(prev => prev.filter(p => p.id !== key));
});
});
// 3. レイアウト構成をロード
layout.loadLayout(config);
layoutRef.current = layout;
const handleResize = () => layout.updateRootSize();
window.addEventListener('resize', handleResize);
return () => {
window.removeEventListener('resize', handleResize);
layout.destroy();
};
}, []);
return (
<div style={{ width: '100vw', height: '100vh', position: 'relative' }}>
<div ref={containerRef} style={{ width: '100%', height: '100%' }} />
{portals.map(p => createPortal(p.component, p.element, p.id))}
</div>
);
}
3. React 19 Portal アーキテクチャの利点
状態の完全保持: パネルのドラッグ、ドロップ、並べ替え操作の最中でも、フォーム入力、スクロール位置、ローカルフック(
useState、useReducer)がリセットされません。Context の伝播: すべての React Context プロバイダー(Zustand、Redux、TanStack Query、ThemeContext)が、ドッキングされたペイン間で維持されます。
自動クリーンアップ: ユーザーがタブを閉じると、Strelit は
container.on(‘destroy’)を発行し、ポータルをクリーンにアンマウントしてメモリリークを防ぎます。
⚡ React でのマルチモニターポップアウトウィンドウをお探しですか?
個別のブラウザウィンドウ間で Strelit がどのように状態を協調させるかについては、専用の
ポップアウトウィンドウの操作チュートリアル
をご覧ください。