既存のレイアウトに対して、ユーザーが新しいアイテムを動的に追加できるようにしたいケースは頻繁にあります。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 上で完全なレイアウト実装を確認、フォーク、テストできます: