カスタム テンプレートがある場合は、コンボ ドロップダウンの ADD BUTTON の描画に使用されます。
// Set in typescript
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.addItemTemplate = myCustomTemplate;
<!-- Set in markup -->
<igx-combo #combo>
...
<ng-template igxComboAddItem>
<button type="button" igxButton="contained" class="combo__add-button">
Click to add item
</button>
</ng-template>
</igx-combo>
項目がデータ コレクションに追加されているときに発生されます。
<igx-combo (addition)='handleAdditionEvent($event)'></igx-combo>
カスタム値をコレクションに追加できるかどうかを制御します。
// get
let comboAllowsCustomValues = this.combo.allowCustomValues;
<!--set-->
<igx-combo [allowCustomValues]='true'></igx-combo>
aria-labelledby 属性値を設定します。
<igx-combo [ariaLabelledBy]="'label1'">
ドロップダウンを開いた後にコンボの検索ボックスにフォーカスするかどうか。
false
の場合、代わりにコンボのリスト項目コンテナーがフォーカスされます。
カスタム テンプレートがある場合は、コンボ CLEAR ボタンを描画するために使用されます。
// Set in typescript
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.clearIconTemplate = myCustomTemplate;
<!-- Set in markup -->
<igx-combo #combo>
...
<ng-template igxComboClearIcon>
<igx-icon>clear</igx-icon>
</ng-template>
</igx-combo>
ドロップダウンが閉じた後に発生されます。
<igx-combo (closed)='handleClosed($event)'></igx-combo>
ドロップダウンが閉じられる前に発生されます。
<igx-combo (closing)='handleClosing($event)'></igx-combo>
新しいデータの塊が仮想化から読み込まれたときに発生されます。
<igx-combo (dataPreLoad)='handleDataPreloadEvent($event)'></igx-combo>
コンボを無効にします。デフォルトは false
です。
<igx-combo [disabled]="'true'">
カスタム テンプレートがある場合は、コンボ ドロップダウンの ADD BUTTON の描画に使用されます。
// Set in typescript
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.emptyTemplate = myCustomTemplate;
<!-- Set in markup -->
<igx-combo #combo>
...
<ng-template igxComboEmpty>
<div class="combo--empty">
There are no items to display
</div>
</ng-template>
</igx-combo>
コンボのカスタム フィルタリング機能を取得または設定します。
カスタム テンプレートがある場合は、コンボ項目リストのための FOOTER の描画に使用されます。
// Set in typescript
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.footerTemplate = myCustomTemplate;
<!-- Set in markup -->
<igx-combo #combo>
...
<ng-template igxComboFooter>
<div class="combo__footer">
This is a custom footer
</div>
</ng-template>
</igx-combo>
カスタム テンプレートがある場合は、コンボ リスト内のグループのため HEADER ITEMS の描画に使用されます。
// Set in typescript
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.headerItemTemplate = myCustomTemplate;
<!-- Set in markup -->
<igx-combo #combo>
...
<ng-template igxComboHeaderItem let-item let-key="groupKey">
<div class="custom-item--group">Group header for {{ item[key] }}</div>
</ng-template>
</igx-combo>
カスタム テンプレートがある場合は、コンボ項目リストのための HEADER の描画に使用されます。
// Set in typescript
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.headerTemplate = myCustomTemplate;
<!-- Set in markup -->
<igx-combo #combo>
...
<ng-template igxComboHeader>
<div class="combo__header">
This is a custom header
</div>
</ng-template>
</igx-combo>
カスタム テンプレートがある場合は、コンボ リストの ITEMS の描画に使用されます。
// Set in typescript
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.itemTemplate = myCustomTemplate;
<!-- Set in markup -->
<igx-combo #combo>
...
<ng-template igxComboItem let-item let-key="valueKey">
<div class="custom-item">
<div class="custom-item__name">{{ item[key] }}</div>
<div class="custom-item__cost">{{ item.cost }}</div>
</div>
</ng-template>
</igx-combo>
ドロップダウン リストの幅を構成します。
// get
let myComboItemsWidth = this.combo.itemsWidth;
<!--set-->
<igx-combo [itemsWidth] = '"180px"'></igx-combo>
ドロップダウンが開かれた後に発生されます。
<igx-combo (opened)='handleOpened($event)'></igx-combo>
ドロップダウンが開かれる前に発生されます。
<igx-combo opening='handleOpening($event)'></igx-combo>
コンボの項目リストの表示方法を制御するカスタム オーバーレイ設定を設定します。 設定:
<igx-combo [overlaySettings]="customOverlaySettings"></igx-combo>
const customSettings = { positionStrategy: { settings: { target: myTarget } } };
combo.overlaySettings = customSettings;
コンボで使用されるカスタム オーバーレイ設定を取得します。
const comboOverlaySettings: OverlaySettings = myCombo.overlaySettings;
コンボの値フィールドのプレースホルダー値を定義します。
// get
let myComboPlaceholder = this.combo.placeholder;
<!--set-->
<igx-combo [placeholder]='newPlaceHolder'></igx-combo>
検索入力の値が変更 (入力、貼り付け、クリアなど) するときに発生されます。
<igx-combo (searchInputUpdate)='handleSearchInputEvent($event)'></igx-combo>
コンボ ドロップダウンの検索フィールドのプレースホルダー値を定義します。
// get
let myComboSearchPlaceholder = this.combo.searchPlaceholder;
<!--set-->
<igx-combo [searchPlaceholder]='newPlaceHolder'></igx-combo>
選択を完了する前に項目選択が変更されるときに発生されます。
<igx-combo (selectionChanging)='handleSelection()'></igx-combo>
caseSensitive アイコンを検索入力に表示するかどうかを定義します。
// get
let myComboShowSearchCaseIcon = this.combo.showSearchCaseIcon;
<!--set-->
<igx-combo [showSearchCaseIcon]='true'></igx-combo>
カスタム テンプレートがある場合は、コンボ TOGGLE (開く/閉じる) ボタンを描画するために使用されます。
// Set in typescript
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.toggleIconTemplate = myCustomTemplate;
<!-- Set in markup -->
<igx-combo #combo>
...
<ng-template igxComboToggleIcon let-collapsed>
<igx-icon>{{ collapsed ? 'remove_circle' : 'remove_circle_outline'}}</igx-icon>
</ng-template>
</igx-combo>
値を決定するためにデータ ソースのどの列を使用するかを決定します。
// get
let myComboValueKey = this.combo.valueKey;
<!--set-->
<igx-combo [valueKey]='myKey'></igx-combo>
要素のスタイルの幅を設定します。
// get
let myComboWidth = this.combo.width;
<!--set-->
<igx-combo [width]='250px'></igx-combo>
ドロップダウン状態を取得します。
let state = this.combo.collapsed;
コンボのデータ ソース。
<!--set-->
<igx-combo [data]='items'></igx-combo>
表示値を決定するためにデータ ソースのどの列を使用するかを決定します。
// get
let myComboDisplayKey = this.combo.displayKey;
// set
this.combo.displayKey = 'val';
<!--set-->
<igx-combo [displayKey]='myDisplayKey'></igx-combo>
コンボ入力に表示するテキスト。
// get
let comboDisplayValue = this.combo.displayValue;
リスト内のフィルタリングを有効または無効にします。デフォルトは true
です。
コンボ項目をフィルタリングする方法を設定します。
// get
let myFilteringOptions = this.combo.filteringOptions;
<!--set-->
<igx-combo [filteringOptions]='myFilteringOptions'></igx-combo>
項目リストで項目をグループ化する項目プロパティです。データが Object[] 型ではない場合に利用できません。
// get
let currentGroupKey = this.combo.groupKey;
項目リストで項目をグループ化する項目プロパティです。データが Object[] 型ではない場合に利用できません。
<!--set-->
<igx-combo [groupKey]='newGroupKey'></igx-combo>
グループのソート順序を設定します。
<igx-combo [groupSortingDirection]="groupSortingDirection"></igx-combo>
public groupSortingDirection = SortingDirection.Asc;
コンボの id を取得または設定します。
// get
let id = this.combo.id;
<!--set-->
<igx-combo [id]='combo1'></igx-combo>
ドロップダウン リスト項目の高さを構成します。
// get
let myComboItemHeight = this.combo.itemHeight;
<!--set-->
<igx-combo [itemHeight]='32'></igx-combo>
ドロップダウン リストの高さを構成します。
// get
let myComboItemsMaxHeight = this.combo.itemsMaxHeight;
<!--set-->
<igx-combo [itemsMaxHeight]='320'></igx-combo>
リソース文字列を取得または設定します。
現在の選択状態を取得します。
リモート サービスを使用する場合、仮想データ項目の合計数を取得します。
// get
let count = this.combo.totalItemCount;
リモート サービスを使用する場合、仮想データ項目の合計数を設定します。
// set
this.combo.totalItemCount(remoteService.count);
ビジュアル コンボ
タイプを設定します。許可される値は line
、box
、border
および search
です。デフォルト値は box
です。
<igx-combo [type]="'line'">
フォームで使用時のコントロールが有効化どうかを取得します。
// get
let valid = this.combo.valid;
フォームで使用時のコントロールが有効化どうかを設定します。
// set
this.combo.valid = IgxInputState.INVALID;
コンボの値です。
// get
let comboValue = this.combo.value;
仮想化データの現在の状態を定義します。startIndex
と chunkSize
を含みます。
// get
let state = this.combo.virtualizationState;
仮想化データの現在の状態を設定します。
// set
this.combo.virtualizationState(state);
1 つの項目を選択/選択解除します。
指定される項目の itemid です。
項目が選択されるか (true) または選択解除されるか (false)。
指定された valueKey なし
this.combo.valueKey = null;
const items: { field: string, region: string}[] = data;
this.combo.setSelectedItem(items[0], true);
指定された valueKey を使用
this.combo.valueKey = 'field';
const items: { field: string, region: string}[] = data;
this.combo.setSelectedItem('Connecticut', true);
編集可能な機能を提供するドロップダウン リストを表します。ユーザーは定義済みのリストからオプションを選択できます。
Igx Module
IgxComboModule
Igx Theme
igx-combo-theme
Igx Keywords
combobox, combo selection
Igx Group
グリッド & リスト
備考
項目をフィルターする機能、および提供されたデータで単一または複数の選択を実行する機能を提供します。 また、キーボード ナビゲーションおよびカスタム スタイル設定機能を公開します。
例