📖チュートリアル一覧▼

タブとタイトルの拡張 (Extending Tabs & Titles)

Strelit Layout はほぼすべての視覚要素に新機能を簡単に追加できるよう設計されており、タブも例外ではありません。このチュートリアルでは、新着メッセージを表示するようなシンプルなカウンターバッジをタブに追加する方法を解説します。

対話型サンプル

対話型サンプル: タブの拡張

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

タブへのアクセス方法

Strelit UI Kit において Tab インスタンスにアクセスする方法は主に2つあります:

  1. レイアウト階層の走査: スタックのヘッダータブ配列にアクセスする(例:stack.header.tabs[0])。
  2. コンポーネントコンテナのイベントを監視: コンポーネントがドッキング、移動、または復元された際、関連するタブが再生成される場合があります。コンテナの tab イベントを監視することで、アクティブなタブインスタンスを確実に取得できます:
container.on('tab', (tab) => {
  tab.element.appendChild(counter);
});

完全な実装例

モダンな TypeScript / ES モジュール構文を使用した完全な実装例です:

myLayout.registerComponentFactoryFunction('example', (container) => {
  // 1. メッセージカウンターバッジを作成
  const counter = document.createElement('span');
  counter.className = 'messageCounter';
  counter.textContent = '3';

  // 2. タブがバインドされるたびにバッジ要素をタブに追加
  container.on('tab', (tab) => {
    tab.element.appendChild(counter);
  });

  // 3. コンテナ要素内にコンポーネントコンテンツを描画
  container.element.innerHTML = '<div class="content">メッセージストリームがアクティブです。</div>';
});

カウンター要素はメモリ上に保持され、tab イベントが発行されるたびにアタッチされるため、タブが新しいスタックにドラッグされたり並べ替えられたりしても、バッジのカウント値とイベントリスナーは失われません。

バッジのスタイリング

.lm_active タブモディファイアを使用して、アクティブ状態と非アクティブ状態をスタイル設定します:

.lm_tab .messageCounter {
  background: var(--bg-surface);
  color: var(--text-secondary);
  border-radius: 10px;
  padding: 2px 6px;
  font-size: 11px;
  margin-left: 6px;
}

.lm_tab.lm_active .messageCounter {
  background: var(--accent-gold);
  color: #0b1220;
  font-weight: bold;
}

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

GitHub で Issue を作成 →