📖チュートリアル一覧▼

React 18 & 19 (Portals 統合)

React 19

モダンな 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 がどのように状態を協調させるかについては、専用の

ポップアウトウィンドウの操作チュートリアル

をご覧ください。

マルチ画面トレーディング端末やエンタープライズ分析ダッシュボードの構築、レガシーレイアウトからの移行など、チームとコミュニティがサポートします。

GitHub で Issue を作成 →