Close
Angular React Web Components Blazor Blazor
Premium

Blazor Dock Manager (ドック マネージャー) の概要

Infragistics Blazor Dock Manager は、ペインでアプリケーションのレイアウトを管理する方法を提供します。エンド ユーザーはペインをピン固定、サイズ変更、移動、最大化、非表示にすることでカスタマイズできます。

Blazor ドック マネージャーの例

この例は、アプリケーションで使用できる IgbDockManager のほとんどの機能とドッキング オプションを示しています。

カスタマイズ

Dock Manager コンポーネントは、スロットとパーツを使用してすべてのボタンをカスタマイズするオプションを提供します。ボタンを変更するには、Dock Manager 内で独自の要素を定義し、slot 属性を対応する識別子に設定します。

これらのスロットとパーツを使用して、カスタマイズされた Dock Manager レイアウトを作成してみましょう。最初に、closeButtonmaximizeButtonminimizeButtonpinButton、および unpinButton スロットを使用して独自のアイコンを提供します。

次に、スタイルシートで公開されたパーツを使用します。こうすることで、コンポーネントのスタイルを完全に制御できるようになります。

igc-dockmanager::part(unpinned-tab-area) {
    background: #bee9ec;
}

igc-dockmanager::part(unpinned-tab-area--left) {
    border-right: 1px dashed #004d7a;
}

igc-dockmanager::part(unpinned-tab-area--bottom) {
    border-top: 1px dashed #004d7a;
}

igc-dockmanager::part(tab-header-close-button),
igc-dockmanager::part(pane-header-close-button) {
    background-color: #e73c7e;
}

igc-dockmanager::part(pane-header-pin-button),
igc-dockmanager::part(pane-header-unpin-button) {
  background: rgb(218, 218, 218);
  border: none;
  width: 24px;
  height: 24px;
  color: #fff;
}

igc-dockmanager::part(tabs-maximize-button),
igc-dockmanager::part(tabs-minimize-button),
igc-dockmanager::part(pane-header-minimize-button),
igc-dockmanager::part(pane-header-maximize-button) {
  width: 24px;
  height: 24px;
  border: none;
  transition: opacity 250ms ease-in-out;
  opacity: 0.3;
  margin-right: 15px;
  margin-top: -5px;
  margin-left: 0px;
}

すべて順調にいけば、アイコンとタブ領域がカスタマイズされた Dock Manager ができあがっているはずです。実際に見てみましょう。

以下に、すべてのボタンおよびスプリッターハンドルのスロット名の一覧を記載しています。

スロット名説明
closeButton閉じるボタン。
paneHeaderCloseButtonペイン ヘッダーの閉じるボタン。
tabHeaderCloseButtonタブ ヘッダーの閉じるボタン。
moreTabsButtonその他のタブ ボタン。
moreOptionsButtonその他のオプション ボタン。
maximizeButton最大化ボタン。
minimizeButton最小化ボタン。
pinButtonピン固定ボタン。
unpinButtonピン固定解除ボタン。
splitterHandleスプリッターハンドル。

各スロットに対応するパーツは、このページのスタイル設定セクションにあるCSS パーツで確認できます。

CSS 変数

次の表では、ドック マネージャー コンポーネントのスタイル設定に使用されるすべての CSS 変数について説明します。

CSS 変数説明
--igc-background-colorペイン ナビゲーター コンポーネント内のヘッダーの背景色。
--igc-accent-colorフォーカスされているペイン ヘッダー アクション パーツ内のボタンの背景色。
--igc-active-colorアクティブな状態のコンポーネントに使用されるテキストとボックス シャドウの色。
--igc-border-colorペイン ヘッダー コンポーネントのボーダー下線の色。
--igc-font-familyドック マネージャー コンポーネントの font-family。
--igc-dock-backgroundドック マネージャー、タブ、およびフローティング ペイン コンポーネントの背景色。
--igc-dock-textドック マネージャーおよびフローティング ペイン コンポーネントのテキストの色。
--igc-pane-header-backgroundペイン ヘッダー コンポーネントの背景色。
--igc-pane-header-textペイン ヘッダー コンポーネントのテキストの色。
--igc-pane-content-backgroundドック マネージャーおよびタブ パネル コンポーネント内のコンテンツの背景色。
--igc-pane-content-textドック マネージャーおよびタブ パネル コンポーネント内のコンテンツのテキストの色。
--igc-tab-textタブ ヘッダー コンポーネントのテキストの色。
--igc-tab-backgroundタブ ヘッダー コンポーネントの背景色。
--igc-tab-border-colorタブ ヘッダー コンポーネントの境界線の色。
--igc-tab-text-active選択したタブ ヘッダー コンポーネントのテキストの色。
--igc-tab-background-active選択したタブ ヘッダー コンポーネントの背景色。
--igc-tab-border-color-active選択したタブ ヘッダー コンポーネントのボーダーの色。
--igc-pinned-header-backgroundピン固定されていないペイン ヘッダー コンポーネントの背景色。
--igc-pinned-header-textピン固定されていないペイン ヘッダー コンポーネントのテキストの色。
--igc-splitter-backgroundスプリッター コンポーネントの背景色。
--igc-splitter-handleスプリッター ハンドルの背景色。
--igc-button-textペイン ヘッダー アクション パーツ内のボタンの色。
--igc-flyout-shadow-colorコンテンツ ペイン コンポーネントのボックス シャドウの色。
--igc-joystick-backgroundジョイスティックとルート ドッキング インジケーター コンポーネントの背景色。
--igc-joystick-border-colorジョイスティックとルート ドッキング インジケーター コンポーネントのボーダーの色。
--igc-joystick-icon-colorジョイスティックとルート ドッキング インジケーター コンポーネントのアイコンの色。
--igc-joystick-background-activeジョイスティックとルート ドッキング インジケーター コンポーネントのホバー背景色。
--igc-joystick-icon-color-activeジョイスティックとルート ドッキング インジケーター コンポーネントのホバー アイコンの色。
--igc-floating-pane-border-colorフローティング ペインのボーダーの色。
--igc-context-menu-backgroundコンテキスト メニュー項目の背景色。
--igc-context-menu-background-activeホバーおよびフォーカス時のコンテキスト メニュー項目の背景色。
--igc-context-menu-colorコンテキスト メニュー項目のテキストの色。
--igc-context-menu-color-activeホバーおよびフォーカス時のコンテキスト メニュー項目のテキストの色。
--igc-drop-shadow-backgroundドロップ シャドウの背景色。
--igc-disabled-color無効状態のコンポーネントのテキストの色。

キーボード ナビゲーション

キーボード ナビゲーションは、ドック マネージャーのアクセシビリティを強化し、すべてのペインをナビゲートしたり、アクティブなペインをドッキングしてビューを複数の方向に分割したりするなど、エンドユーザーにさまざまな操作を提供します。

ショートカットは以下の通りです。

ドッキング

  • CMD/CTRL + SHIFT + グローバルの上へのドック。
  • CMD/CTRL + SHIFT + グローバルの下へのドック。
  • CMD/CTRL + SHIFT + グローバルの右へのドック。
  • CMD/CTRL + SHIFT + グローバルの左へのドック。
  • SHIFT + タブ グループに複数のタブがある場合、ビューが分割され、フォーカスされたタブが上にドッキングされます。
  • SHIFT + タブ グループに複数のタブがある場合、ビューが分割され、フォーカスされたタブが下にドッキングされます。
  • SHIFT + タブ グループに複数のタブがある場合、ビューが分割され、フォーカスされたタブが右にドッキングされます。
  • SHIFT + タブ グループに複数のタブがある場合、ビューが分割され、フォーカスされたタブが左にドッキングされます。

ナビゲーション

  • CMD/CTRL + F6 または CMD/CTRL + ドキュメント ホストの次のタブにフォーカスします。
  • CMD/CTRL + SHIFT + F6 または CMD/CTRL + ドキュメント ホストの前のタブにフォーカスします。
  • ALT + F6 次のコンテンツ ペインにフォーカスします。
  • ALT + SHIFT + F6 前のコンテンツ ペインにフォーカスします。

ペイン ナビゲーター

次のキーボード ショートカットは、ペインやドキュメントを反復できるナビゲーターを示しています。

  • CMD/CTRL + F7 または CMD/CTRL + F8 最初のドキュメントから開始します。
  • ALT + F7 または ALT + F8 最初のペインから開始します。
  • CMD/CTRL + SHIFT + F7 または CMD/CTRL + SHIFT + F8 最後のドキュメントから逆方向に開始します。
  • ALT + SHIFT + F7 または ALT + SHIFT + F8 最後のペインから逆方向に開始します。

その他

  • ALT + F3 アクティブなペインを閉じます。

サンプル demo で上記のすべてのアクションを練習しましょう。

スタイル設定

ドック マネージャーは、シャドウ DOM を使用してスタイルと動作をカプセル化します。その結果、通常の CSS セレクターでその内部要素を単純にターゲットにすることはできません。そのため :: part CSS セレクターでターゲットにできるコンポーネント parts を公開しています。

igc-dockmanager::part(content-pane) {
  border-radius: 10px;
}

以下の例では、公開されているCSSパーツを使用してDock Managerをカスタマイズする方法をご紹介します。

CSS パーツ

パーツ名説明
content-paneコンテンツ ペイン コンポーネント。
pane-headerコンテンツ ペインのヘッダー コンポーネント。
pane-header-contentコンテンツ ペイン ヘッダーのコンテンツ領域。
pane-header-actionsコンテンツ ペイン ヘッダーのアクション領域。
activeアクティブ状態を示します。pane-headerpane-header-contentpane-header-actionstab-header に適用されます。
floatingフローティング ペインの配置を示します。pane-headerpane-header-contentpane-header-actions に適用されます。
windowフローティング ウィンドウの配置を示します。pane-headerpane-header-contentpane-header-actions に適用されます。
split-paneスプリット ペイン コンポーネント。
splitterサイズ変更スプリッター コンポーネント。
splitter-baseスプリッター コンポーネントの基本要素。
splitter-ghostスプリッター コンポーネントのゴースト要素。
unpinned-pane-header固定されていないペイン ヘッダー コンポーネント。
tab-headerタブ ヘッダー コンポーネント。
tab-header-more-options-buttonタブ ヘッダーのその他のオプション ボタン。
tab-header-close-buttonタブ ヘッダーの閉じるボタン。
selected選択状態を示します。tab-header および tab-header-close-button に適用されます。
hoveredホバー状態を示します。tab-header-close-button に適用されます。
header-titleタブ ヘッダーのテキスト タイトル。
tab-strip-areaタブ ヘッダーを含むタブ ストリップ領域。
tab-strip-actionsタブ アクションを含むタブ ストリップ領域。
topタブの上位置を示します。tab-headertab-strip-areatab-strip-actions に適用されます。
bottomタブの下位置を示します。tab-headertab-strip-areatab-strip-actions に適用されます。
context-menuコンテキスト メニュー コンポーネント。
context-menu-itemコンテキスト メニュー コンポーネントの項目。
docking-previewドッキング プレビュー地域。
docking-indicator非ルート ドッキング インジケーター。
root-docking-indicatorルート ドッキング インジケーター。
splitter-docking-indicatorスプリッター ドッキング インジケーター。
pane-navigatorペイン ナビゲーター コンポーネント。
pane-navigator-headerペイン ナビゲーターのヘッダー領域。
pane-navigator-bodyペイン ナビゲーターの本体領域。
pane-navigator-items-groupペイン ナビゲーター コンポーネントの項目グループ。
pane-navigator-items-group-titleペイン ナビゲーターの項目グループのタイトル要素。
pane-navigator-itemペイン ナビゲーターの項目。
pane-header-close-buttonペイン ヘッダーの閉じるボタン。
pane-header-maximize-buttonペイン ヘッダーの最大化ボタン。
pane-header-minimize-buttonペイン ヘッダーの最小化ボタン。
pane-header-pin-buttonペイン ヘッダーのピン固定ボタン。
pane-header-unpin-buttonペイン ヘッダーのピン固定解除ボタン。
tabs-maximize-buttonタブの最大化ボタン。
tabs-minimize-buttonタブの最小化ボタン。
tabs-more-buttonその他のタブ ボタン。
context-menu-unpin-buttonコンテキスト メニューのピン固定解除ボタン。
context-menu-close-buttonコンテキスト メニューの閉じるボタン。
splitter-handleスプリッターのハンドル。
horizontal水平位置を示します。splitter-handle に適用されます。
vertical垂直位置を示します。splitter-handle に適用されます。

API リファレンス

IgbDockManager
IgbDocumentHost
IgbDockManagerLayout
IgbContentPane
IgbSplitPane
IgbTabGroupPane