Combo (コンボ)
Ignite UI for Angular Combo は、入力フィールドと検索可能なドロップダウン リストを組み合わせたコンポーネントで、ユーザーは入力してオプションをフィルタリングし、1 つ以上の項目を選択できます。
Angular Combo は igx-combo コンポーネントです。仮想化されたドロップダウン リストにオプションを表示し、フィルタリング、グループ化、カスタム値、および Angular フォームとの双方向バインディングをサポートします。
ライブ デモ
構造
Combo は、入力フィールドと検索可能なドロップダウン リストを組み合わせたもので、ユーザーは入力してオプションをフィルタリングし、1 つ以上の項目を選択できます。
2. ラベル (オプション): ユーザーが選択する内容を説明するテキストです
3. 左アイコン (オプション): フィールドに文脈を加える、先頭のアイコンです
4. ヒント テキスト: 追加のガイダンスとして、フィールドの下に表示されるヘルパー テキストです
5. プレースホルダー テキスト: 値が選択されていない場合に表示される既定のテキストです
6. トグル: オプション リストを開いたり閉じたりするために使用します
7. 検索入力: 入力してリストをフィルタリングできます
8. ドロップダウン ヘッダー: ドロップダウンのオプションをグループ化または説明するために使用します
9. 選択された項目: ドロップダウン リストから選択された項目です
10. ドロップダウン リスト: 選択可能なオプションのリストを表示します
igx-combo 要素は、入力フィールドを入力グループ内に、ドロップダウン リストをオーバーレイ内にレンダリングします:
igx-combo
├─ igx-input-group
│ ├─ [igxLabel]
│ ├─ igx-prefix
│ ├─ input[igxInput][role="combobox"] // read-only, shows the selected items
│ ├─ igx-suffix.igx-combo__clear-button // shown when the Combo has a value
│ ├─ igx-suffix.igx-combo__toggle-button
│ └─ igx-hint
└─ igx-combo-drop-down // the dropdown, shown in an overlay
└─ div.igx-drop-down__list-scroll[role="listbox"]
└─ div.igx-combo
├─ div.igx-combo__search // hidden with disableFiltering
│ └─ input[igxInput][role="searchbox"]
├─ [igxComboHeader] template
├─ div.igx-combo__content // the options
│ └─ igx-combo-item[role="option"] // role="group" for the group headers
├─ div.igx-combo__add // the empty message and the add item button
│ └─ igx-combo-add-item[role="button"] // shown with allowCustomValues
└─ [igxComboFooter] template
作業の開始
Angular Combo を使用するには、基本的なプロジェクトのセットアップについて Ignite UI for Angular 作業の開始トピックに従い、続いて対象のプラットフォーム向けにコンポーネントを追加します。
プロジェクトで Ignite UI for Angular をまだ使用していない場合は、ng add igniteui-angular を実行します。次に、IGX_COMBO_DIRECTIVES トークンをインポートし、コンポーネントの imports に追加します。このトークンには、IgxComboComponent とそのテンプレート ディレクティブが含まれています:
import { Component } from '@angular/core';
import { IGX_COMBO_DIRECTIVES } from 'igniteui-angular/combo';
// import { IGX_COMBO_DIRECTIVES } from '@infragistics/igniteui-angular/combo'; for licensed package
@Component({
selector: 'app-home',
template: `
<igx-combo [data]="cities" valueKey="id" displayKey="name" placeholder="Cities"></igx-combo>
`,
imports: [IGX_COMBO_DIRECTIVES]
})
export class HomeComponent {
public cities = [
{ id: 'BG01', name: 'Sofia' },
{ id: 'BG02', name: 'Plovdiv' },
{ id: 'BG03', name: 'Varna' }
];
}
使用方法
ユーザーが長いリスト (都市や国のリストなど) から 1 つ以上のオプションを選択し、そのリストを検索する必要がある場合は、Angular Combo を使用します。
タイプ (Material テーマ)
Material テーマでは、Combo の入力には、単色の背景上でより構造的に見せるための境界線タイプと、鮮やかな画像の上に配置したときに読みやすさを向上させるのに最適なボックス タイプがあります。Bootstrap、Fluent、Indigo テーマでは、どちらのタイプも同じように描画されるため、このトピックの他のサンプルでは、ボックス タイプを Material テーマでのみ表示します。
Angular Combo は既定でボックス タイプを使用します。境界線タイプにするには、type 入力プロパティを border に設定します。ラベルは igxLabel ディレクティブで、左アイコンは igx-prefix で追加します:
<!-- Border type -->
<igx-combo type="border" placeholder="Select a value" [data]="options">
<label igxLabel>Label</label>
<igx-prefix><igx-icon>language</igx-icon></igx-prefix>
</igx-combo>
<!-- Box type -->
<igx-combo type="box" placeholder="Select a value" [data]="options">
<label igxLabel>Label</label>
</igx-combo>
無効状態
Angular Combo に disabled を設定すると、境界線タイプとボックス タイプの両方の無効状態が表示されます。
<igx-combo type="border" [disabled]="true" placeholder="Country" [data]="countries"></igx-combo>
サイズ
Combo には、大、中、小の 3 つのサイズがあります。ドロップダウンは、選択したサイズに合わせて寸法が自動的に調整されます。サイズは --ig-size CSS 変数で設定します:
.small {
--ig-size: var(--ig-size-small);
}
.large {
--ig-size: var(--ig-size-large);
}
インタラクション状態
Combo コンポーネントは、有効なバリエーションに対して、アイドル、アイドルとホバー、入力済み、入力済みとホバー、フォーカスの 5 つの状態と、成功、警告、エラーの 3 つの検証状態をサポートします。
入力フィールドまたはトグルをクリックすると、ドロップダウンが開きます。コードでドロップダウンを開閉するには、open、close、toggle メソッドを使用します:
@ViewChild(IgxComboComponent, { static: true })
public combo: IgxComboComponent;
public openCombo(): void {
this.combo.open();
}
次のサンプルでは、各状態を並べて表示します。ホバーとフォーカスはポインターとキーボードによって発生するため、このサンプルでは、表示専用の Combo で、テーマのホバー スタイルとフォーカス スタイルを有効にしています。
検証状態
経験豊富なデザイナーは、ユーザー入力を制限して無効な状態を避けるために制約を適切に使用します。そのため、検証スタイルが用意されています。利用可能な検証スタイルにより、Combo の入力は標準の Input と一貫性を保ち、成功、警告、エラーの視覚効果を表示する高度なデザインにも対応します。
Angular Combo は、ngModel またはリアクティブ フォームを介してバインドされているフォーム コントロールから検証状態を取得します。コードで状態を設定するには、valid プロパティに IgxInputState 値を設定します。Angular Combo には独自の警告状態がないため、サンプルでは入力グループの警告スタイルで表示しています。ガイダンスまたはエラー メッセージは igx-hint に配置します:
<igx-combo type="border" [data]="countries" valueKey="id" displayKey="name" [(ngModel)]="selection" required>
<igx-hint>Please select a different region</igx-hint>
</igx-combo>
ドロップダウンのサイズ
Combo に使用されるドロップダウンは、通常の Dropdown コンポーネントと同様に、大、中、小の Combo に適したサイズで提供されます。ドロップダウンのサイズは Combo から決まるため、Combo に --ig-size 変数を設定します。
Angular Combo は、項目とリストの高さを設定する itemHeight および itemsMaxHeight 入力プロパティも公開します:
<igx-combo [data]="countries" [itemHeight]="40" [itemsMaxHeight]="160"></igx-combo>
次のサンプルでは、入力フィールドを除いて、ドロップダウンのみを表示します。
ドロップダウンの検索入力
Angular Combo のドロップダウンには、ユーザーの入力に合わせてオプションをフィルタリングする検索入力が含まれています。
空の検索入力のテキストは resourceStrings の igx_combo_filter_search_placeholder エントリで設定し、大文字と小文字を区別するフィルタリングを切り替えるボタンは showSearchCaseIcon で表示し、検索入力は disableFiltering で非表示にします。filteringOptions 入力プロパティは、検索でフィルタリングに使用するキー、およびフィルタリングで大文字と小文字を区別するかどうかを設定します:
<igx-combo [data]="cities" displayKey="name" [resourceStrings]="{ igx_combo_filter_search_placeholder: 'Search cities' }" [showSearchCaseIcon]="true"
[filteringOptions]="{ filteringKey: 'name', caseSensitive: false }">
</igx-combo>
次のサンプルでは、検索入力のみを表示します。ホバーとフォーカスはポインターとキーボードによって発生するため、このサンプルでは、表示専用の検索入力で、テーマのホバー スタイルとフォーカス スタイルを有効にしています。
データ バインディング
Angular Combo は、data にバインドした配列からオプションのリストを構築します。配列にオブジェクトが含まれる場合は、Combo が使用するキーを設定します:
valueKey- オプションを識別するフィールドです。Combo の値と選択で使用されます。省略した場合、Combo はオブジェクトへの参照を使用します。displayKey- リストと入力フィールドに表示するフィールドです。省略した場合、Combo はvalueKeyを使用します。groupKey- オプションをグループ化するフィールドです。各グループにヘッダーが表示され、groupSortingDirectionでグループを並べ替えます。Combo の機能トピックのグループ化を参照してください。
リモート サービスから読み込まれるデータにバインドするには、Combo の機能トピックのリモート バインディングを参照してください。
配列に文字列や数値などのプリミティブ値が含まれる場合は、valueKey と displayKey を設定しないでください。Combo は値そのものを使用します。
値と選択
Angular Combo は、選択された項目を値を通じて公開し、コードで項目を選択および選択解除するメソッドを提供します。
Angular Combo は [(ngModel)] による双方向バインディングをサポートし、テンプレート駆動フォームとリアクティブ フォームで動作します。selection プロパティは選択された項目を返し、select、deselect、selectAllItems、deselectAllItems メソッドで変更します:
<igx-combo [data]="cities" displayKey="name" valueKey="id" [(ngModel)]="selectedCities"></igx-combo>
export class CitiesComponent {
@ViewChild(IgxComboComponent, { static: true })
public combo: IgxComboComponent;
public selectedCities: string[] = ['BG01', 'UK01'];
public selectFavorites(): void {
this.combo.select(['UK01', 'BG01']);
}
}
Angular Combo は、選択が変更される前にキャンセル可能な selectionChanging を発行し、選択が確定した後に selectionChanged を発行します。
ユーザーが単一の項目を選択し、入力フィールドに入力できるようにするには、Simple Combo を使用します。
推奨 / 非推奨
Combo を使用する場合、入力とドロップダウンは同じ幅にし、左右の境界線を揃える必要があります。Combo にフォーカスがあるときは、表示のきっかけとなった Combo より後ろにあるコンテンツの上に、ドロップダウンを常に重ねて表示する必要があります。Combo は、展開パネルのようにコンテンツを押し下げることはありません。
入力とドロップダウンの幅が同じで、左右の境界線が揃うように、ドロップダウンを入力に合わせます。
ドロップダウンが入力より狭い、または位置がずれていると、両者の視覚的なつながりが損なわれるため避けてください。
プロパティ
Angular Combo は次のプロパティを公開します。完全な型定義については、API リファレンスを参照してください。
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
data |
any[] |
— | Combo のオプションです。 |
valueKey |
string |
— | オプションを識別するフィールドです。 |
displayKey |
string |
— | リストと入力フィールドに表示するフィールドです。省略した場合は valueKey を使用します。 |
groupKey |
string |
— | オプションをグループ化するフィールドです。 |
type |
IgxInputGroupType |
'box' |
入力フィールドのタイプです (box、border、または line)。 |
placeholder |
string |
— | 項目が選択されていない場合に入力フィールドに表示されるテキストです。 |
resourceStrings |
IComboResourceStrings |
— | 空の検索入力に表示されるテキストを含む、Combo のテキストです。 |
disabled |
boolean |
false |
Combo が無効かどうかです。 |
disableFiltering |
boolean |
false |
検索入力を非表示にするかどうかです。 |
showSearchCaseIcon |
boolean |
false |
検索入力に、大文字と小文字を区別するフィルタリングを切り替えるボタンを表示するかどうかです。 |
filteringOptions |
IComboFilteringOptions |
— | 検索でフィルタリングに使用するキー、およびフィルタリングで大文字と小文字を区別するかどうかを指定します。 |
allowCustomValues |
boolean |
false |
ユーザーが検索入力のテキストを新しい項目として追加できるかどうかです。 |
disableClear |
boolean |
false |
クリア ボタンを非表示にするかどうかです。 |
autoFocusSearch |
boolean |
true |
ドロップダウンが開いたときに、検索入力にフォーカスするかどうかです。 |
itemHeight |
number |
— | リスト内の項目の高さです。 |
itemsMaxHeight |
number |
— | リストの最大の高さです。 |
valid |
IgxInputState |
INITIAL |
Combo の検証状態です。 |
selection |
any[] |
— | 読み取り専用です。選択された項目です。 |
メソッド
Angular Combo は次のメソッドを公開します。
| メソッド | 説明 |
|---|---|
select |
渡された項目を選択します。2 番目の引数に true を渡すと、先に現在の選択をクリアします。 |
deselect |
渡された項目を選択解除します。 |
selectAllItems |
すべての項目を選択します。true を渡すと、現在のフィルターを無視します。 |
deselectAllItems |
すべての項目を選択解除します。true を渡すと、現在のフィルターを無視します。 |
open |
ドロップダウンを開きます。 |
close |
ドロップダウンを閉じます。 |
toggle |
ドロップダウンが閉じている場合は開き、開いている場合は閉じます。 |
イベント
Angular Combo は次のイベントを発行します。
| 名前 | 説明 |
|---|---|
selectionChanging |
選択が変更される前に IComboSelectionChangingEventArgs とともに発行されます。選択を維持するには、cancel を設定します。 |
selectionChanged |
選択が確定した後に IComboSelectionChangedEventArgs とともに発行されます。 |
opening |
ドロップダウンが開く前に発行されます。キャンセル可能です。 |
opened |
ドロップダウンが開いた後に発行されます。 |
closing |
ドロップダウンが閉じる前に発行されます。キャンセル可能です。 |
closed |
ドロップダウンが閉じた後に発行されます。 |
searchInputUpdate |
検索入力のテキストが変更されたときに発行されます。 |
addition |
ユーザーがリストにカスタム値を追加する前に発行されます。 |
スタイル設定
Combo には、入力とドロップダウンの各部分を組み合わせた柔軟なスタイル設定が用意されています。入力テキスト要素の色、枠線のスタイルと色を変更できます。ドロップダウンでは、背景色を変更したり、検索入力や、背景色とテキスト色を持つ項目など、Combo のドロップダウン内の項目に関するさまざまなオプションを使用したりできます。
次の CSS 変数で、Angular Combo のトグル ボタンとクリア ボタンの色を変更します:
| 変数 | 変更内容 |
|---|---|
--ig-combo-toggle-button-background |
トグル ボタンの背景。 |
--ig-combo-toggle-button-foreground |
トグル ボタンのアイコンの色。 |
--ig-combo-toggle-button-foreground-filled |
Combo に値がある場合の、トグル ボタンのアイコンの色。 |
--ig-combo-toggle-button-background-focus |
Combo にフォーカスがある場合の、トグル ボタンの背景。 |
--ig-combo-toggle-button-foreground-focus |
Combo にフォーカスがある場合の、トグル ボタンのアイコンの色。 |
--ig-combo-toggle-button-background-disabled |
Combo が無効な場合の、トグル ボタンの背景。 |
--ig-combo-toggle-button-foreground-disabled |
Combo が無効な場合の、トグル ボタンのアイコンの色。 |
--ig-combo-clear-button-background |
クリア ボタンの背景。 |
--ig-combo-clear-button-foreground |
クリア ボタンのアイコンの色。 |
--ig-combo-search-separator-border-color |
検索入力とリストの間の線の色。 |
--ig-combo-empty-list-placeholder-color |
空のリストが表示するテキストの色。 |
入力フィールドは --ig-input-group-* 変数から、ドロップダウンは --ig-drop-down-* 変数から、項目のチェックボックスは --ig-checkbox-* 変数から色を取得するため、これらすべてを Combo に設定できます。
Sass テーマ
プライマリ プロパティを変更すると、関連するすべての依存プロパティが自動的に更新され、変更が反映されます。combo-theme 関数のプライマリ パラメーターは $toggle-button-background で、テーマはここからすべての状態のトグル ボタンの色を導出します。Combo、そのドロップダウン、およびそのチェックボックスのテーマを作成し、tokens() ミックスインでインクルードします。このミックスインは、インクルードしたスコープに、対応する CSS 変数を出力します。
@use "igniteui-angular/theming" as *;
$custom-combo-theme: combo-theme(
$toggle-button-background: #e0e0e0
);
$custom-drop-down-theme: drop-down-theme(
$background-color: #e6f2ff
);
$custom-checkbox-theme: checkbox-theme(
$fill-color: #005dcc,
$empty-color: #005dcc
);
:host {
@include tokens($custom-combo-theme);
@include tokens($custom-drop-down-theme);
@include tokens($custom-checkbox-theme);
}
Angular Combo は、ドロップダウンをオーバーレイに表示します。ビューのカプセル化とオーバーレイ アウトレットの場所によっては、:host 配下にインクルードしたテーマがドロップダウンに適用されない場合があります。オーバーレイのスタイル設定トピックを参照してください。
CSS 変数
Sass のビルド手順なしでローカルにスタイルを設定する必要がある場合は、Combo またはコンテナーに CSS 変数を設定します:
.styled-combo {
--ig-input-group-border-color: #1377d5;
--ig-combo-toggle-button-background: #e0e0e0;
--ig-drop-down-background-color: #e6f2ff;
--ig-drop-down-selected-item-background: #4ca7e3;
--ig-checkbox-fill-color: #005dcc;
}
Tailwind によるスタイル設定
カスタム Tailwind ユーティリティ クラスを使用して、Angular Combo のスタイルを設定できます。最初に Tailwind をセットアップしてください。
グローバル スタイルシートに Ignite UI ユーティリティをインポートします:
@import "tailwindcss";
@import "igniteui-theming/tailwind/utilities/material.css";
対応するテーマには light-combo または dark-combo クラスを使用し、生成された CSS 変数を任意のプロパティでオーバーライドします:
<igx-combo class="!light-combo ![--toggle-button-background:#e5ebf3] ![--clear-button-foreground:#212121]">
...
</igx-combo>
感嘆符 (!) により、Tailwind ユーティリティが Combo の既定のテーマ スタイルより優先されます。
アクセシビリティ
Angular Combo は、WAI-ARIA の combobox パターンのロールを使用します。入力フィールドはオプションの listbox を制御する combobox であり、ユーザーはキーボードでリストを開き、移動し、オプションを選択します。
キーボード操作
Angular Combo の入力フィールドはタブ ストップです。Combo にフォーカスがある間は、次のキーが機能します:
| キー | 動作 |
|---|---|
| Arrow Down / Alt + Arrow Down | 閉じている Combo では、ドロップダウンを開いてフォーカスを検索入力に移します。検索入力では、フォーカスを最初のオプションに移します。リストが空でカスタム値が許可されている場合は、項目の追加ボタンに移します。リストでは、次のオプションに移動し、最後のオプションからは、項目の追加ボタンが表示されている場合はそこに移動します。 |
| Arrow Up / Alt + Arrow Up | 検索入力では、ドロップダウンを閉じてフォーカスを Combo に移します。リストでは、前のオプションに移動します。最初のオプションからは、フォーカスを検索入力に戻します。検索入力がない場合は、ドロップダウンを閉じてフォーカスを Combo に移します。 |
| Home / End | リストでは、最初または最後のオプションに移動します。 |
| Space | リストでは、アクティブなオプションを選択または選択解除します。 |
| Enter | リストでは、選択を確定してドロップダウンを閉じます。項目の追加ボタンでは、検索入力のテキストを新しい項目として追加して選択します。 |
| Escape | ドロップダウンが開いている場合は、ドロップダウンを閉じてフォーカスを Combo に維持します。ドロップダウンが閉じている場合は、選択をクリアします。 |
| Tab | ドロップダウンを閉じて、フォーカスを次のフォーカス可能な要素に移します。 |
スクリーン リーダー / ARIA
Angular Combo は、次のロールと属性をレンダリングします:
| 要素 | ロール | 属性 |
|---|---|---|
| 入力フィールドの入力 | combobox |
aria-haspopup="listbox"、aria-expanded、リストを指す aria-controls、aria-labelledby、および aria-label |
| 検索入力 | searchbox |
aria-autocomplete="list" および aria-label="search" |
| ドロップダウン | listbox |
igxLabel または ariaLabelledBy 要素を指す aria-labelledby |
| オプションのコンテナー | — | aria-multiselectable="true"、およびアクティブなオプションを指す aria-activedescendant |
| 各オプション | option |
aria-selected |
| 各グループ ヘッダー | group |
— |
| 項目の追加ボタン | button |
リソース文字列からの aria-label |
入力フィールドは、igxLabel または ariaLabelledBy 入力プロパティからアクセシブル名を取得します。これらがない場合は、オプションが選択されているかどうかを示すリソース文字列から名前を取得します。
アクセシビリティ準拠
Infragistics は、Ignite UI for Angular のアクセシビリティ サポートについて、Section 508 および WCAG 2.1 のガイドライン領域をアクセシビリティ準拠トピックで説明しています。
| 基準 | コンポーネントの準拠方法 |
|---|---|
| 1.3.1 情報及び関係性 | combobox、listbox、option ロールが構造を公開し、リストにはigxLabel または ariaLabelledBy 要素によってラベルが付けられます。 |
| 2.1.1 キーボード | 矢印キーでドロップダウンを開いてオプション間を移動し、Space キーでアクティブなオプションを選択します。 |
| 2.1.2 キーボード トラップなし | Tab キーでドロップダウンを閉じ、フォーカスを Combo の外に移します。 |
| 4.1.2 名前 (name)・役割 (role)・値 (value) | 入力フィールドは、combobox ロール、ラベルからの名前、および aria-expanded による展開状態を公開します。各オプションは、aria-selected による選択状態を公開します。 |
ユーザー側の責任:
- すべての Combo に、ユーザーが選択する内容を示すラベルを付けます。タイプを参照してください。
- テーマの色をオーバーライドする場合は、1.4.11 非テキストのコントラストで求められているとおり、枠線とフォーカス インジケーターに 3:1 以上のコントラスト比を維持します。
- エラー メッセージは、色だけでなくヘルパー テキストに表示します。検証状態を参照してください。
既知の制限
- 選択された項目を表示する入力フィールドは編集できません。Firefox では、カーソルが表示されます。
- Angular Combo が
undefinedを含むプリミティブの配列にバインドされている場合、リストにundefinedは表示されません。オブジェクトのvalueKeyフィールドがundefinedの場合、リストに項目は表示されますが、ユーザーは選択できません。 - Angular Combo がリモート サービスにバインドされていて、事前定義された選択がある場合、データが読み込まれるまで入力フィールドは空白のままです。
- リストは Virtual Scroll を使用するため、その制限が適用されます。リストは表示範囲内のオプションのみをレンダリングするため、DOM を照会するコードは、それらのオプションしか見つけられません。
API リファレンス
Angular Combo の API リファレンスには、対象プラットフォームの完全な API が記載されています。
依存関係
Angular Combo は、色とサイズを適用するためにテーマが必要です。フレームワーク固有のセットアップについては、作業の開始を参照してください。
Angular Combo は、Drop Down、Input Group、Checkbox、Icon、および Overlay を使用します。これらのテーマが、Combo の各部分のスタイルを設定します:
その他のリソース
次のリソースでは、Angular Combo に関するその他のガイダンスとプロジェクトのサポートを提供します:
関連コンポーネント
Angular Combo は、ユーザーがリストを検索して 1 つ以上のオプションを選択できるコンポーネントです。選択の動作が異なる場合は、次のコンポーネントを使用します:
- Select - 検索が不要な短いリストから、ユーザーが 1 つのオプションを選択する場合は、Select を使用します。
- Dropdown - ボタンまたは別の要素からアクションまたはオプションのリストを表示するには、Dropdown を使用します。
- Simple Combo - ユーザーが単一の項目を選択し、入力フィールドに入力してリストをフィルタリングしたり、カスタム値を入力したりする場合は、Simple Combo を使用します。
FAQ
これらの質問では、Angular Combo の一般的なセットアップ、選択、および使用のシナリオを取り上げます。
Angular Combo を [(ngModel)] またはフォーム コントロールで valueKey の値の配列にバインドするか、項目を指定して select メソッドを呼び出します。valueKey がない場合、Angular Combo は data 内のオブジェクトへの参照を使用します。
Angular Combo では、常に複数選択が可能です。ユーザーが単一の項目を選択する必要がある場合は、Simple Combo を使用します。Simple Combo では、入力フィールドに入力してリストをフィルタリングすることもできます。
Angular Combo の groupKey を、各オプションのグループを保持するフィールドに設定します。Angular Combo は各グループのヘッダーを表示し、グループを並べ替えます。
リストが長い場合、ユーザーがリストを検索する必要がある場合、または複数のオプションを選択する場合は、Angular Combo を使用します。検索せずに短いリストから 1 つのオプションを選択する場合は、Angular Select を使用します。