📖チュートリアル一覧▼

アイテムの動的追加 (Adding Items Dynamically)

既存のレイアウトに対して、ユーザーが新しいアイテムを動的に追加できるようにしたいケースは頻繁にあります。Strelit Layout は、これを実現するための複数の柔軟な方法を提供しています。

  • ページ上の任意の DOM 要素を、ドラッグ時にレイアウトアイテムへ変化する「ドラッグソース (dragSource)」にする

  • ユーザーが要素を選択して、その中にアイテムを追加できるようにする
  • 指定した親要素にプログラムからアイテムを直接追加する

レイアウトの作成

このチュートリアルでは、コンポーネントメニューのスペースを確保するため、body ではなく div 内にレイアウトを挿入します。

<div id="wrapper">
  <ul id="menuContainer"></ul>
  <div id="layoutContainer"></div>
</div>

行内に2つのコンポーネントが並ぶシンプルな基本レイアウトを作成しましょう:

const config = {
  root: {
    type: 'row',
    content: [
      {
        type: 'component',
        componentType: 'example',
        title: 'パネル 1',
        componentState: { text: 'コンポーネント 1' },
      },
      {
        type: 'component',
        componentType: 'example',
        title: 'パネル 2',
        componentState: { text: 'コンポーネント 2' },
      },
    ],
  },
};

const layoutContainer = document.getElementById('layoutContainer');
const myLayout = new StrelitLayout(layoutContainer);

myLayout.registerComponentFactoryFunction('example', (container, itemConfig) => {
  const state = itemConfig.componentState || {};
  container.element.innerHTML = '<h2>' + state.text + '</h2>';
});

myLayout.loadLayout(config);

「コンポーネント追加」メニューの作成

標準 DOM API を使用して、メニューアイテム要素を作成します:

const menuContainer = document.getElementById('menuContainer');

const addMenuItem = (text) => {
  const element = document.createElement('li');
  element.textContent = text;
  element.className = 'menu-item';
  menuContainer.appendChild(element);
  return element;
};

const itemA = addMenuItem('ユーザー追加コンポーネント A');
const itemB = addMenuItem('ユーザー追加コンポーネント B');

方法 1: ドラッグソース (Drag Source) の作成

Strelit Layout では、任意の DOM 要素をドラッグソース に設定できます。要素をドラッグすると、新しいタブ付きコンポーネントがレイアウトワークスペースにドロップされます。

モダンな Strelit UI Kit では、newDragSource(element, itemConfigCallback) を呼び出します。コールバックはドラッグ開始時にコンポーネント構成を動的に生成します:

myLayout.newDragSource(itemA, () => ({
  type: 'component',
  componentType: 'example',
  title: 'コンポーネント A',
  componentState: { text: 'ドラッグソース A から作成' },
}));

myLayout.newDragSource(itemB, () => ({
  type: 'component',
  componentType: 'example',
  title: 'コンポーネント B',
  componentState: { text: 'ドラッグソース B から作成' },
}));

どちらのメニュー項目をレイアウト内にドラッグしても、ドラッグプロキシが表示され、レイアウトツリーの任意の位置にスムーズにドッキングされます。

対話型サンプル: ドラッグソースからのアイテム追加

CodePen 上で完全なレイアウト実装を確認、フォーク、テストできます:

方法 2: addComponent() によるプログラム挿入

ドラッグせずにクリック操作でコンポーネントを追加するには、myLayout.addComponent() を使用します。これにより、現在アクティブまたはフォーカスされているスタックに新しいコンポーネントが自動的にドッキングされます:

itemA.addEventListener('click', () => {
  myLayout.addComponent('example', { text: 'クリックで追加 A' }, '追加コンポーネント A');
});

方法 3: 特定の親コンテナへのアイテム追加

ツリー内の特定のターゲットアイテム(ルートコンテナ、特定の行、列、スタックなど)に直接コンポーネントを追加することも可能です:

itemB.addEventListener('click', () => {
  const newComp = myLayout.newComponent('example', { text: 'ルート行に追加' }, '新規行タブ');

  // ルートの row/stack アイテムに子として追加
  if (myLayout.rootItem) {
    myLayout.rootItem.addChild(newComp);
  }
});

対話型サンプル: 定義済み親要素へのアイテム追加

CodePen 上で完全なレイアウト実装を確認、フォーク、テストできます:

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

GitHub で Issue を作成 →