カスタム値をコレクションに追加できるかどうかを制御します。
// 取得
let comboAllowsCustomValues = this.combo.allowCustomValues;
<!--set-->
<igx-combo [allowCustomValues]='true'></igx-combo>
aria-labelledby 属性を設定する @Input プロパティ。
<igx-combo [ariaLabelledBy]="'label1'">
onOpened
イベントが呼び出された後に
コンボの検索ボックスにフォーカスするかどうかを制御する
@Inputプロパティ。
カスタム テンプレートがある場合は、コンボ CLEAR (開く/閉じる) ボタンを描画するために使用されます。
// Typescript に設定
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.clearIconTemplate = myCustomTemplate;
<!-- マークアップに設定 -->
<igx-combo #combo>
...
<ng-template igxComboClearIcon>
<igx-icon>clear</igx-icon>
</ng-template>
</igx-combo>
コンボを有効/無効にする @Input プロパティ。デフォルトは false
。
<igx-combo [disabled]="'true'">
カスタム テンプレートがある場合は、コンボ ドロップダウンの ADD BUTTON の描画に使用されます。
// Typescript に設定
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.emptyTemplate = myCustomTemplate;
<!-- マークアップに設定 -->
<igx-combo #combo>
...
<ng-template igxComboEmpty>
<div class="combo--empty">
There are no items to display
</div>
</ng-template>
</igx-combo>
リストでフィルタリングを有効/無効にする @Input プロパティ。デフォルトは true
です。
<igx-combo [filterable]="false">
カスタム テンプレートがある場合は、コンボ項目リストのための FOOTER の描画に使用されます。
// Typescript に設定
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.footerTemplate = myCustomTemplate;
<!-- マークアップに設定 -->
<igx-combo #combo>
...
<ng-template igxComboFooter>
<div class="combo__footer">
This is a custom footer
</div>
</ng-template>
</igx-combo>
カスタム テンプレートがある場合は、コンボ リスト内のグループのため HEADER ITEMS の描画に使用されます。
// Typescript に設定
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.headerItemTemplate = myCustomTemplate;
<!-- マークアップに設定 -->
<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 の描画に使用されます。
// Typescript に設定
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.headerTemplate = myCustomTemplate;
<!-- マークアップに設定 -->
<igx-combo #combo>
...
<ng-template igxComboHeader>
<div class="combo__header">
This is a custom header
</div>
</ng-template>
</igx-combo>
コンボの id を取得または設定します。
// 取得
let id = this.combo.id;
<!--set-->
<igx-combo [id]='combo1'></igx-combo>
カスタム テンプレートがある場合は、コンボ リストの ITEMS の描画に使用されます。
// Typescript に設定
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.itemTemplate = myCustomTemplate;
<!-- マークアップに設定 -->
<igx-combo #combo>
...
<ng-template igxComboItem>
<div class="custom-item" let-item let-key="valueKey">
<div class="custom-item__name">{{ item[key] }}</div>
<div class="custom-item__cost">{{ item.cost }}</div>
</div>
</ng-template>
</igx-combo>
ドロップダウン リストの幅を構成します。
// 取得
let myComboItemsWidth = this.combo.itemsWidth;
<!--set-->
<igx-combo [itemsWidth] = '"180px"'></igx-combo>
項目がデータ コレクションに追加されているときに発生されます。
<igx-combo (onAddition)='handleAdditionEvent()'></igx-combo>
ドロップダウンが閉じられた後に発生されます。
<igx-combo (onClosed)='handleClosed()'></igx-combo>
ドロップダウンが閉じる前に発生されます。
<igx-combo (onClosing)='handleClosing($event)'></igx-combo>
新しいデータの塊が仮想化から読み込まれたときに発生されます。
<igx-combo (onDataPreLoad)='handleDataPreloadEvent()'></igx-combo>
ドロップダウンが開いた後に発生されます。
<igx-combo (onOpened)='handleOpened()'></igx-combo>
ドロップダウンが開く前に発生されます。
<igx-combo onOpening='handleOpening($event)'></igx-combo>
検索入力の値が変更 (入力、貼り付け、クリアなど) するときに発生されます。
<igx-combo (onSearchInput)='handleSearchInputEvent()'></igx-combo>
選択が完了する前に項目の選択が変更されたときに発生されます。
<igx-combo (onSelectionChange)='handleSelection()'></igx-combo>
コンボの項目リストの表示方法を制御するカスタム オーバーレイ設定を設定します。 設定:
<igx-combo [overlaySettings] = "customOverlaySettings"></igx-combo>
const customSettings = { positionStrategy: { settings: { target: myTarget } } };
combo.overlaySettings = customSettings;
コンボで使用されるカスタム オーバーレイ設定を取得します。
const comboOverlaySettings: OverlaySettings = myCombo.overlaySettings;
コンボの値フィールドのプレースホルダー値を定義します。
// 取得
let myComboPlaceholder = this.combo.placeholder;
<!--set-->
<igx-combo [placeholder]='newPlaceHolder'></igx-combo>
コンボ ドロップダウンの検索フィールドのプレースホルダー値を定義します。
// 取得
let myComboSearchPlaceholder = this.combo.searchPlaceholder;
<!--set-->
<igx-combo [searchPlaceholder]='newPlaceHolder'></igx-combo>
caseSensitive アイコンを検索入力に表示するかどうかを定義します。
// 取得
let myComboShowSearchCaseIcon = this.combo.showSearchCaseIcon;
<!--set-->
<igx-combo [showSearchCaseIcon]='true'></igx-combo>
カスタム テンプレートがある場合は、コンボ TOGGLE (開く/閉じる) ボタンを描画するために使用されます。
// Typescript に設定
const myCustomTemplate: TemplateRef<any> = myComponent.customTemplate;
myComponent.combo.toggleIconTemplate = myCustomTemplate;
<!-- マークアップに設定 -->
<igx-combo #combo>
...
<ng-template igxComboToggleIcon let-collapsed>
<igx-icon>{{ collapsed ? 'remove_circle' : 'remove_circle_outline'}}</igx-icon>
</ng-template>
</igx-combo>
コンボ値データソース プロパティ。
// 取得
let myComboValueKey = this.combo.valueKey;
<!--set-->
<igx-combo [valueKey]='myKey'></igx-combo>
要素のスタイルの幅を設定します。
// 取得
let myComboWidth = this.combo.width;
<!--set-->
<igx-combo [width]='250px'></igx-combo>
ドロップダウン状態を取得します。
let state = this.combo.collapsed;
コンボのデータ ソース。
<!--set-->
<igx-combo [data]='items'></igx-combo>
コンボのデータ ソース。
<!--set-->
<igx-combo [data]='items'></igx-combo>
コンポーネントのテーマを返します。
デフォルト テーマは comfortable
です。
利用可能なオプションは comfortable
、cosy
、および compact
です。
let componentTheme = this.component.displayDensity;
コンポーネントのテーマを設定します。
コンボ テキスト データ ソース プロパティ。
// 取得
let myComboDisplayKey = this.combo.displayKey;
// 設定
this.combo.displayKey = 'val';
<!--set-->
<igx-combo [displayKey]='myDisplayKey'></igx-combo>
項目リストで項目をグループ化する項目プロパティ。データが Object[] 型ではない場合に利用できません。
// 取得
let currentGroupKey = this.combo.groupKey;
項目リストで項目をグループ化する項目プロパティ。データが Object[] 型ではない場合に利用できません。
<!--set-->
<igx-combo [groupKey]='newGroupKey'></igx-combo>
ドロップダウン リスト項目の高さを構成します。
// 取得
let myComboItemHeight = this.combo.itemHeight;
<!--set-->
<igx-combo [itemHeight]='32'></igx-combo>
ドロップダウン リスト項目の高さを構成します。
// 取得
let myComboItemHeight = this.combo.itemHeight;
<!--set-->
<igx-combo [itemHeight]='32'></igx-combo>
ドロップダウン リストの高さを構成します。
// 取得
let myComboItemsMaxHeight = this.combo.itemsMaxHeight;
<!--set-->
<igx-combo [itemsMaxHeight]='320'></igx-combo>
ドロップダウン リストの高さを構成します。
// 取得
let myComboItemsMaxHeight = this.combo.itemsMaxHeight;
<!--set-->
<igx-combo [itemsMaxHeight]='320'></igx-combo>
リモート サービスを使用する場合、仮想データ項目の合計数を取得します。
// 取得
let count = this.combo.totalItemCount;
リモート サービスを使用する場合、仮想データ項目の合計数を設定します。
// 設定
this.combo.totalItemCount(remoteService.count);
コンボのスタイルを設定する @Input プロパティ。
有効な値は line
、box
、border
、search
です。デフォルトは box
です。
<igx-combo [type]="'line'">
コンボのスタイルを設定する @Input プロパティ。
有効な値は line
、box
、border
、search
です。デフォルトは box
です。
<igx-combo [type]="'line'">
フォームで使用時のコントロールが有効化どうかを取得します。
// 取得
let valid = this.combo.valid;
フォームで使用時のコントロールが有効化どうかを設定します。
// 設定
this.combo.valid = IgxComboState.INVALID;
コンボ入力に表示するテキスト。
// 取得
let comboValue = this.combo.value;
仮想化データの現在の状態を定義します。startIndex
と chunkSize
を含みます。`
// 取得
let state = this.combo.virtualizationState;
仮想化データの現在の状態を設定します。
// 設定
this.combo.virtualizationState(state);
コンボを閉じるメソッド。
<button (click)="combo.close()">Close Combo</button>
<igx-combo #combo></igx-combo>
フィルター済みのすべての項目の選択を解除します。
True に設定されている場合、すべての項目の選択を解除します。そうでない場合、フィルターのみの項目を選択解除します。
this.combo.deselectAllItems();
定義済みの項目の選択を解除します。
選択解除される項目。
this.combo.deselectItems(["New York", "New Jersey"]);
コンボを開くメソッド。
<button (click)="combo.open()">Open Combo</button>
<igx-combo #combo></igx-combo>
すべての項目 (フィルター済み) を選択します。
True に設定されている場合、すべての項目を設定します。そうでない場合、フィルターのみの項目を選択します。
this.combo.selectAllItems();
定義済みの項目を選択します。
選択される新しい項目。
True の場合、前回選択した項目がクリアされます。
this.combo.selectItems(["New York", "New Jersey"]);
現在の選択状態を取得します。
選択された項目の配列
let selectedItems = this.combo.selectedItems();
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);
コンボを開く/閉じるメソッド。
<button (click)="combo.toggle()">Toggle Combo</button>
<igx-combo #combo></igx-combo>
コンボ ビューに変更検出をトリガーします。
カスタム テンプレートがある場合は、コンボ ドロップダウンの ADD BUTTON の描画に使用されます。