Premium

Angular Tree Grid 列選択

列選択機能は、シングルクリックで列全体を選択する簡単な方法を提供します。特定の列の重要性を強調するために、ヘッダーセルとその下のすべてにフォーカスします。この機能は豊富な API を備えて選択状態の操作、選択した部分からのデータ抽出、データ分析操作、可視化が可能になります。

Angular 列選択の例

以下のサンプルは、Tree Grid の列選択動作の 3 つのタイプを示します。使用可能な各選択モードを有効にするには、以下の [列選択] ドロップダウンを使用します。

*Units、Unit Price および Delivered 列の選択が無効になっています。

基本的な使用方法

列選択機能は、GridSelectionMode 値を受け取る columnSelection 入力によって有効にすることができます。

インタラクション

デフォルトの選択モードは none です。single または multiple に設定されると、すべての列は selectable になります。列を選択するには、列をクリックして selected としてマークします。列が選択不可な場合、ホバー時に選択スタイルはヘッダーに適用されません。

複数列ヘッダー は selectable 入力に反映されません。その子の 1 つ以上で選択動作が有効な場合、ColumnGroup は selectable です。さらに、すべての selectable 子孫が selected である場合、コンポーネントは selected としてマークされます。

*Personal Details 列グループでは、ID 列および Title 列のみを選択できます。

キーボードの組み合わせ

キーボードの組み合わせは、グリッドの columnSelection 入力が multiple に設定されている場合にのみ使用できます。

列の選択機能のキーボードナビゲーションには 2 つのオプションがあります。

複数列選択 - Ctrl キーを押しながら、すべての選択可能なヘッダーセルをクリック。
範囲列の選択 - Shift キーを押しながら + クリック、間にあるすべての選択可能な列を選択します。

API 操作

API は、非表示列に関していくつかの追加機能を提供し、対応する setter を設定することにより、すべての非表示列を selected としてマークできます。

上記は ColumnGroup にも適用されますが、selected プロパティを変更する場合、その子孫の状態を変更します。

API 操作の詳細については、API リファレンス セクションを参照してください。

スタイル設定

スタイル設定オプションに移動する前に、core ジュールとすべてのコンポーネントミックスインをインポートする必要があります。

@use "igniteui-angular/theming" as *;

// 重要: Ignite UI for Angular 13 より前のバージョンは、次を使用してください。
// @import '~igniteui-angular/lib/core/styles/themes/index';

行選択と列選択は個別に操作できないことに注意してください。同じ変数に依存します。

選択とホバーのスタイル設定を変更します。
最も簡単な方法は、カスタム テーマを定義する方法です。

$custom-grid-theme: grid-theme(
  $row-selected-background: #011627,
  $row-selected-text-color: #ecaa53,
  $row-selected-hover-background: #011627,
  $header-selected-text-color: #ecaa53,
  $header-selected-background: #011627,
  $expand-icon-color: #ecaa53,
  $expand-icon-hover-color: #b64b80
);

grid-theme はいくつかのパラメーターを受け入れますが、選択したすべての列の外観を変更するのは以下の 5 つです。

$row-selected-background- 選択した部分の背景を設定します。
$row-selected-text-color - 選択した部分のテキスト色を設定します。
$row-selected-hover-background - ホバーされたセルまたは複数のセルの色を設定します。
$header-selected-text-color - 選択した列ヘッダーのテキスト色を設定します。
$header-selected-background - 選択した列ヘッダーの背景色を設定します。

CSS 変数の使用

最後にカスタム igx-grid テーマを含めます。

:host {
  @include tokens($custom-grid-theme)
}

デモ

このサンプルは、Change Theme (テーマの変更) から選択したグローバルテーマに影響を受けません。

API リファレンス

以下は、列選択 UI のその他の API です。

TreeGrid プロパティ:

Column プロパティ:

ColumnGroup プロパティ:

TreeGrid イベント:

onColumnsSelectionChange

その他のリソース

コミュニティに参加して新しいアイデアをご提案ください。