Single Selection Combo (単一選択コンボ)
Ignite UI for Web Components Single Selection Combo は、ユーザーが 1 つのオプションを選択し、入力フィールドに入力して検索可能なドロップダウン リストをフィルタリングできる Combo です。
Web Components Combo で singleSelect を設定すると、単一選択に切り替わります。入力フィールドが編集可能になり、ユーザーの入力に応じてリストがフィルタリングされます。ドロップダウンの検索入力は非表示になり、オプションにチェックボックスは表示されません。
Combo には 2 つのレイアウト オプションがあります。単一選択の Combo (Simple Combo) と Combo (複数選択) です。
ライブ デモ
構造
Simple Combo は 2 つの要素で構成されます。現在の選択項目またはプレースホルダーを含む入力と、定義済みのドロップダウン リストからオプションを選択するために表示されるドロップダウンです。
2. ラベル (オプション): ユーザーが何を選択するかを説明するテキストです
3. 左アイコン (オプション): フィールドに文脈を追加する、先頭のオプション アイコンです
4. ヒント テキスト: 追加のガイダンスとしてフィールドの下に表示されるヘルパー テキストです
5. プレースホルダー テキスト: 値が選択されていないときに表示される既定のテキストです
6. トグル: オプション リストを開閉するために使用します
7. ドロップダウン ヘッダー: ドロップダウンのオプションをグループ化または説明するために使用します
8. 選択項目: ドロップダウン リストから選択された項目です
9. ドロップダウン リスト: 選択可能なオプションのリストを表示します
単一選択モードでは、igc-combo 要素は編集可能な入力フィールドをレンダリングし、ドロップダウンの検索入力を非表示にして、チェックボックスなしでオプションをレンダリングします。
igc-combo[single-select]
└─ #shadow-root
├─ igc-popover
│ ├─ igc-input#target[slot="anchor"] // the editable input field, exported as the "input" part
│ │ ├─ slot[name="prefix"]
│ │ ├─ span[part="clear-icon"] // shown when the Combo has a value
│ │ ├─ slot[name="suffix"]
│ │ └─ span[part="toggle-icon"]
│ └─ div[part="list-wrapper"] // the dropdown
│ ├─ div[part="filter-input"][hidden] // the search input is hidden
│ ├─ div[part="header"]
│ │ └─ slot[name="header"]
│ ├─ igc-virtual-scroll#dropdown[part="list"][role="listbox"]
│ │ ├─ igc-combo-header[part="group-header"] // one for each group
│ │ └─ igc-combo-item[part="item"][hide-checkbox] // one for each option
│ ├─ div[part="empty"] // shown when the list has no options
│ │ └─ slot[name="empty"]
│ └─ div[part="footer"]
│ └─ slot[name="footer"]
└─ igc-validator#combo-helper-text // the helper text and the validation messages, exported as the "helper-text" part
作業の開始
Web Components Single Selection Combo を使用するには、基本的なプロジェクト セットアップについて Ignite UI for Web Components の作業の開始 トピックに従い、対象のプラットフォーム向けにコンポーネントを追加します。
単一選択モードは Combo のモードであるため、パッケージ、登録、およびテーマ CSS は Combo のものと同じです。
igniteui-webcomponents パッケージをインストールします。
npm install igniteui-webcomponents
次に、Combo とそのテーマ CSS をインポートし、コンポーネントを登録します。
import { defineComponents, IgcComboComponent } from 'igniteui-webcomponents';
import 'igniteui-webcomponents/themes/light/bootstrap.css';
defineComponents(IgcComboComponent);
single-select 属性を指定して Combo をレンダリングし、data をバインドします。
<igc-combo id="countries" single-select value-key="id" display-key="name" label="Country"></igc-combo>
const combo = document.getElementById('countries') as IgcComboComponent;
combo.data = [
{ id: 'BY', name: 'Belarus' },
{ id: 'BE', name: 'Belgium' },
{ id: 'BG', name: 'Bulgaria' }
];
使用方法
国や都市など、ユーザーが検索する必要があるリストから 1 つのオプションだけを選ぶ場合は、Web Components Single Selection Combo を使用します。
タイプ (Material テーマ)
Material テーマでは、Simple Combo の入力で、単色の背景上でより構造的に見える境界線タイプと、鮮やかな画像の上に配置したときに読みやすさを高めるのに最適なボックス タイプのどちらかを選択できます。Bootstrap、Fluent、Indigo テーマでは両方のタイプが同じ見た目で描画されるため、このトピックのその他のサンプルでは、ボックス タイプを Material テーマでのみ表示しています。
Web Components Combo は既定でボックス タイプを使用します。境界線タイプにするには outlined を設定します。
<!-- Border type -->
<igc-combo single-select outlined label="Label" placeholder="Select a value"></igc-combo>
<!-- Box type -->
<igc-combo single-select label="Label" placeholder="Select a value"></igc-combo>
ラベルは label プロパティで、左アイコンは prefix スロットで追加します。アイコンは、Icon トピックで説明されているように、先に登録します。
無効状態
Web Components Single Selection Combo で disabled を設定すると、境界線タイプとボックス タイプの両方の無効状態が表示されます。
<igc-combo single-select outlined disabled placeholder="Country"></igc-combo>
サイズ
Combo には、大、中、小の 3 つのサイズがあります。ドロップダウンは、選択したサイズに合わせて自動的に寸法を調整します。サイズは --ig-size CSS 変数で設定します。
.small {
--ig-size: var(--ig-size-small);
}
.large {
--ig-size: var(--ig-size-large);
}
Web Components Combo は既定で中サイズです。
インタラクション状態
Combo コンポーネントは、有効なバリアントに対して 5 つの状態 (アイドル、アイドル & ホバー、入力済み、入力済み & ホバー、フォーカス) と、3 つの検証状態 (成功、警告、エラー) をサポートします。
入力フィールドまたはトグルをクリックするとドロップダウンが開き、入力フィールドに入力するとドロップダウンが開いてリストがフィルタリングされます。コードでドロップダウンを開閉するには、open プロパティ、または show、hide、toggle メソッドを使用します。
const combo = document.getElementById('countries') as IgcComboComponent;
await combo.show();
await combo.hide();
await combo.toggle();
次のサンプルでは、各状態を並べて表示します。ホバーとフォーカスはポインターとキーボードによって発生するため、このサンプルでは、表示専用の Combo に対して、テーマのホバー スタイルとフォーカス スタイルを有効にしています。
検証状態
経験豊富なデザイナーは、ユーザー入力を制限して無効な状態を避けるために制約を適切に使用します。そのため、検証スタイルが用意されています。利用可能な検証スタイルにより、Combo の入力は標準の Input と一貫性を保ち、成功、警告、エラーの視覚表現を表示する高度なデザインにも対応できます。
Web Components Combo はフォームに関連付けられます。選択項目を必須にするには required を、エラー状態を表示するには invalid を設定します。ガイダンスまたはエラー メッセージは helper-text スロットに配置します。単一選択モードでは、フォームの値は選択項目の valueKey の値です。Combo には成功状態や警告状態が組み込まれていません。サンプルでは、成功状態と警告状態を、エラーの色の代わりにテーマの成功色または警告色を使用する、invalid を設定した Combo として表示しています。
<igc-combo single-select outlined required invalid placeholder="Country">
<span slot="helper-text">Please select a different region</span>
</igc-combo>
ドロップダウンのサイズ
Combo に使用されるドロップダウンは、通常の Dropdown コンポーネントと同様に、大、中、小の Combo に適したサイズで提供されます。ドロップダウンは Combo からサイズを取得するため、--ig-size 変数は Combo に設定します。
次のサンプルでは、入力フィールドを除いたドロップダウンのみを表示します。
ドロップダウン項目
Simple Combo に使用されるドロップダウンは、ヘッダーと単一選択項目の 2 種類の項目をサポートします。どちらも大、中、小のサイズで利用できます。ヘッダーを使用すると、項目をグループに整理できます。
groupKey に各オプションのグループを保持するフィールドを設定すると、Web Components Single Selection Combo はグループごとにヘッダーを表示します。単一選択モードのオプションにはチェックボックスが表示されません。項目とヘッダーの内容を変更するには、Combo テンプレートトピックを参照してください。
<igc-combo single-select value-key="id" display-key="name" group-key="region"></igc-combo>
次のサンプルでは、各サイズのヘッダーと項目を表示します。
ドロップダウン項目の状態
Web Components Single Selection Combo のドロップダウンの項目は、アイドル、ホバー、フォーカスのいずれかの状態になり、各状態には選択済みのバリアントがあります。ドロップダウン テーマには、無効な項目用の色も含まれています。
次のサンプルでは、各状態を並べて表示します。ホバーとフォーカスはポインターとキーボードによって発生するため、このサンプルでは、表示専用の項目に、テーマのホバー、フォーカス、無効の各状態のスタイルを適用しています。
データ バインディング
Web Components Single Selection Combo は、Combo と同じ方法でオプションをバインドします。data を配列にバインドし、配列がオブジェクトを保持する場合は valueKey、displayKey、groupKey を設定します。Combo トピックのデータ バインディングを参照してください。
値と選択
Web Components Single Selection Combo は 1 つの選択項目を保持し、その値と選択 API を通じて公開します。
value は、選択項目を 1 要素の配列として保持します。要素は、その valueKey の値、または valueKey がない場合はオブジェクト参照です。Combo が最初にレンダリングされるときに項目を選択するには、これを設定します。select メソッドは 1 つの項目を選択して前の項目の選択を解除するため、1 つの項目を渡します。deselect メソッドは選択を解除します。項目を指定せずに呼び出すと、単一選択モードでは select が選択をクリアします。
// select the item matching the 'BG' value of the value key field
combo.select('BG');
// deselect it
combo.deselect('BG');
console.log(combo.value); // ['BG'] while Bulgaria is selected, [] after the deselection
Combo は、ユーザーが選択を変更する前に igcChange を発行します。イベントの詳細には、新しい値、変更された項目、および変更の種類が含まれており、このイベントをキャンセルすると選択は維持されます。
フィルタリング
Web Components Single Selection Combo の入力フィールドに入力すると、ドロップダウンが開き、入力したテキストを含むオプションにリストがフィルタリングされます。最初の一致がアクティブなオプションになるため、Enter キーで選択できます。
ユーザーの入力中にリスト全体を維持するには、disableFiltering を設定します。filteringOptions オブジェクトは、フィルタリングに使用するキー、およびフィルタリングで大文字と小文字を区別するかどうか、発音区別記号を照合するかどうかを設定します。選択されたオプションがない状態で Combo がフォーカスを失うと、入力フィールドはクリアされます。
combo.filteringOptions = { filterKey: 'name', caseSensitive: false, matchDiacritics: true };
推奨 / 非推奨
Simple Combo を使用する場合、その入力とドロップダウンは同じ幅にし、左右の境界線を揃える必要があります。Simple Combo にフォーカスが当たったときのドロップダウンは、表示をトリガーした Simple Combo の後に続くコンテンツの上に常に重ねて表示する必要があります。Combo は、展開パネルのようにコンテンツを押し下げることはありません。
入力とドロップダウンを揃え、同じ幅と一致する左右の境界線にします。
入力よりも狭いドロップダウンや、位置がずれたドロップダウンは、両者の視覚的なつながりを損なうため避けてください。
プロパティ
Web Components Single Selection Combo は次のプロパティを公開します。単一選択モードは Combo のモードであるため、完全なセットについては Combo トピックを参照してください。完全な型定義については API リファレンスを参照してください。
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
singleSelect |
boolean |
false |
ユーザーが 1 つの項目を選択し、入力フィールドからリストをフィルタリングするかどうか。 |
data |
T[] |
[] |
Combo のオプション。 |
valueKey |
string |
— | オプションを識別するフィールド。 |
displayKey |
string |
— | リストと入力フィールドに表示するフィールド。valueKey にフォールバックします。 |
groupKey |
string |
— | オプションをグループ化するフィールド。 |
value |
ComboValue<T>[] |
[] |
選択項目。1 つの valueKey の値または 1 つのオブジェクト参照を持つ配列。 |
label |
string |
— | Combo のラベル。 |
placeholder |
string |
— | 項目が選択されていないときに入力フィールドに表示されるテキスト。 |
outlined |
boolean |
false |
Combo が境界線タイプを使用するかどうか。 |
open |
boolean |
false |
ドロップダウンが開いているかどうか。 |
disabled |
boolean |
false |
Combo が無効かどうか。 |
required |
boolean |
false |
Combo が有効になるために選択項目を必要とするかどうか。 |
invalid |
boolean |
false |
Combo が無効状態を表示するかどうか。 |
disableFiltering |
boolean |
false |
入力フィールドへの入力時にリストをフィルタリングしないかどうか。 |
filteringOptions |
FilteringOptions<T> |
— | フィルタリングに使用するキー、およびフィルタリングで大文字と小文字を区別するかどうか、発音区別記号を照合するかどうか。 |
disableClear |
boolean |
false |
クリア ボタンを非表示にするかどうか。 |
selection |
T[] |
— | 読み取り専用。data のオブジェクトとしての選択項目で、1 要素の配列。 |
メソッド
Web Components Single Selection Combo は次のメソッドを公開します。
| メソッド | 説明 |
|---|---|
select |
渡された項目を valueKey の値または参照で選択し、前の項目の選択を解除します。何も渡さない場合は選択をクリアします。 |
deselect |
渡された項目を valueKey の値または参照で選択解除します。 |
show |
ドロップダウンを開きます。 |
hide |
ドロップダウンを閉じます。 |
toggle |
ドロップダウンが閉じているときは開き、開いているときは閉じます。 |
checkValidity |
Combo が検証制約を満たしているかどうかを返します。 |
reportValidity |
Combo の有効性を確認し、失敗した場合は無効状態を表示します。 |
イベント
Web Components Single Selection Combo は次のイベントを発行します。
| 名前 | 説明 |
|---|---|
igcChange |
ユーザーが選択を変更する前に発行されます。イベントの詳細には、新しい値、変更された項目、および変更の種類が含まれます。選択を維持するには、イベントをキャンセルします。 |
igcOpening |
ユーザーがドロップダウンを開く前に発行されます。キャンセル可能です。 |
igcOpened |
ユーザー操作でドロップダウンが開いた後に発行されます。 |
igcClosing |
ユーザーがドロップダウンを閉じる前に発行されます。キャンセル可能です。 |
igcClosed |
ユーザー操作でドロップダウンが閉じた後に発行されます。 |
スタイル設定
Simple Combo は、入力とドロップダウンの両方の要素を組み合わせた柔軟なスタイル設定を提供します。入力テキスト要素の色、境界線のスタイルと色のオプションがあります。ドロップダウンについては、背景色を変更したり、Simple Combo ドロップダウン内の項目に関するさまざまなオプションで背景色とテキスト色を変更したりできます。
Web Components Single Selection Combo のトグル ボタンとクリア ボタンの色は、次の CSS 変数で変更できます。
| 変数 | 変更内容 |
|---|---|
--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-empty-list-placeholder-color |
空のリストが表示するテキストの色。 |
入力フィールドは --ig-input-group-* 変数から、ドロップダウンは --ig-drop-down-* 変数から色を取得するため、これらすべてを Combo に設定できます。単一選択モードではチェックボックスが表示されないため、--ig-checkbox-* 変数は効果がありません。
igc-combo 要素は、単一選択モードで次の CSS パーツを公開します。
| パーツ | スタイル設定の対象 |
|---|---|
input |
入力フィールド。 |
native-input |
入力フィールドのネイティブ入力。 |
label |
ラベル。 |
prefix |
prefix スロットのコンテナー。 |
suffix |
suffix スロットのコンテナー。 |
toggle-icon |
トグル ボタン。Combo に値があるときは filled が追加されます。 |
clear-icon |
クリア ボタン。 |
helper-text |
ヘルパー テキスト。 |
list-wrapper |
ドロップダウン。 |
header |
header スロットのコンテナー。 |
list |
オプションのリスト。 |
group-header |
リスト内の各グループ ヘッダー。 |
item |
リスト内の各オプション。アクティブなオプションと選択されたオプションには、それぞれ active と selected が追加されます。 |
empty |
empty スロットのコンテナー。 |
footer |
footer スロットのコンテナー。 |
Sass テーマ
プライマリ プロパティを変更すると、関連するすべての依存プロパティが自動的に更新され、変更が反映されます。combo-theme 関数のプライマリ パラメーターは $toggle-button-background で、テーマはこれからすべての状態のトグル ボタンの色を導出します。Combo とそのドロップダウンのテーマを作成し、tokens() ミックスインでインクルードします。このミックスインは、インクルードしたスコープに対応する CSS 変数を出力します。
Sass 関数は igniteui-theming パッケージに含まれています。Sass のセットアップについては、テーマトピックを参照してください。
@use "igniteui-theming" as *;
$custom-combo-theme: combo-theme(
$toggle-button-background: #e0e0e0
);
$custom-drop-down-theme: drop-down-theme(
$background-color: #e6f2ff,
$selected-item-background: #4ca7e3
);
:root {
@include tokens($custom-combo-theme);
@include tokens($custom-drop-down-theme);
}
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;
}
その他のスタイルには CSS パーツを使用します。
igc-combo::part(group-header) {
color: #005dcc;
}
igc-combo::part(item selected) {
color: #000;
}
Tailwind によるスタイル設定
カスタム Tailwind ユーティリティ クラスを使用して、Web Components Single Selection Combo のスタイルを設定できます。最初に Tailwind をセットアップしてください。
Tailwind の任意のプロパティで --ig-combo-*、--ig-input-group-*、--ig-drop-down-* CSS 変数を設定します。
<igc-combo single-select class="[--ig-input-group-border-color:#a9b8cc] [--ig-combo-toggle-button-background:#e5ebf3] [--ig-drop-down-background-color:#f3f6fa]">
</igc-combo>
アクセシビリティ
Web Components Single Selection Combo は、WAI-ARIA コンボボックス パターンのロールを使用します。編集可能な入力フィールドはオプションの listbox を制御する combobox であり、ユーザーは入力でリストをフィルタリングし、キーボードでオプションを選択します。
キーボード操作
Web Components Single Selection Combo の入力フィールドはタブ ストップであり、ユーザーが入力している間もフォーカスは入力フィールドに留まります。Combo にフォーカスがある間は、次のキーが機能します。
| キー | 操作 |
|---|---|
| 印字可能な文字 | 入力フィールドで、ドロップダウンを開き、リストをフィルタリングし、最初の一致をアクティブにします。 |
| Arrow Down / Alt + Arrow Down | 入力フィールドでは、ドロップダウンを開き、フォーカスをリストに移動し、最初のオプションをアクティブにします。リストでは、次のオプションをアクティブにします。 |
| Arrow Up | 入力フィールドでは、ドロップダウンを閉じます。リストでは、前のオプションをアクティブにします。最初のオプションからは、ドロップダウンを閉じてフォーカスを入力フィールドに移動します。 |
| Home / End | リストで、最初または最後のオプションをアクティブにします。 |
| Space | リストで、アクティブなオプションを選択し、選択済みの場合は選択を解除します。 |
| Enter | アクティブなオプションがある場合、それを選択し、ドロップダウンを閉じて、テキストを選択した状態でフォーカスを入力フィールドに移動します。 |
| Escape | ドロップダウンが開いているときは、閉じてフォーカスを入力フィールドに移動します。ドロップダウンが閉じているときは、選択をクリアします。 |
| Tab / Shift + Tab | ドロップダウンが開いているときは、アクティブなオプションを選択し、ドロップダウンを閉じて、フォーカスを次または前のフォーカス可能な要素に移動します。 |
無効な Combo はこれらのキーを無視します。
スクリーン リーダー / ARIA
Web Components Single Selection Combo は、次のロールと属性をレンダリングします。
| 要素 | ロール | 属性 |
|---|---|---|
| 入力フィールド | combobox |
aria-haspopup="listbox"、aria-expanded、aria-disabled、リストを指す aria-controls、およびヘルパー テキストがある場合はそれを指す aria-describedby |
list パーツ |
listbox |
aria-multiselectable="false"、入力フィールドを指す aria-labelledby、およびアクティブなオプションを指す aria-activedescendant |
各 item パーツ |
option |
aria-selected、aria-posinset、aria-setsize |
clear-icon パーツ |
button |
リソース文字列からの aria-label |
Web Components Single Selection Combo は、支援技術に対して次のようにも動作します。
- 入力フィールドは、
labelからアクセシブル名を取得します。ラベルがない場合は、オプションが選択されているかどうかを示すリソース文字列から名前を取得します。 - 入力フィールドは編集可能であり、ユーザーが入力したテキストがリストのフィルターになります。
- フォーカスがリストにある間、アクティブなオプションは
aria-activedescendantを通じて読み上げられます。 - 閉じているドロップダウンのコンテンツは
inertです。
アクセシビリティ準拠
Infragistics は、アクセシビリティ準拠トピックで、Section 508 と WCAG 2.1 のガイドライン領域に対する Ignite UI for Web Components のアクセシビリティ サポートを文書化しています。
| 基準 | コンポーネントの準拠方法 |
|---|---|
| 1.3.1 情報及び関係性 | combobox、listbox、option ロールが構造を公開し、リストは入力フィールドによってラベル付けされます。 |
| 2.1.1 キーボード | 入力でリストがフィルタリングされ、矢印キーでドロップダウンを開いてオプション間を移動でき、Enter キーでアクティブなオプションを選択します。 |
| 2.1.2 キーボード トラップなし | Tab キーでドロップダウンが閉じ、フォーカスが Combo の外に移動します。 |
| 4.1.2 名前、役割、値 | 入力フィールドは、combobox ロール、ラベルからの名前、および aria-expanded による展開状態を公開します。各オプションは、aria-selected によって選択状態を公開します。 |
開発者の責任:
- すべての Combo に、ユーザーが何を選択するかを示すラベルを付けます。タイプ (Material テーマ)を参照してください。
- テーマの色をオーバーライドする場合は、1.4.11 非テキストのコントラストで要求されているとおり、境界線とフォーカス インジケーターに 3:1 以上のコントラスト比を維持します。
- エラー メッセージは、色だけでなくヘルパー テキストに表示します。検証状態を参照してください。
既知の制限
- 単一選択モードではドロップダウンの検索入力が非表示になるため、
placeholderSearch、caseSensitiveIcon、autofocusListは効果がありません。 - Web Components Combo はカスタム値を追加しません。入力フィールドのテキストがどのオプションにも一致しない場合、Combo はフォーカスを失ったときに入力フィールドをクリアします。
API リファレンス
Web Components Single Selection Combo の API リファレンスは、対象プラットフォームの完全な API サーフェスを一覧表示します。
依存関係
Web Components Single Selection Combo は、色とサイズを適用するためにテーマを必要とします。フレームワーク固有のセットアップについては、作業の開始を参照してください。
IgcComboComponent の登録では、Combo がレンダリングする要素も登録されます。Icon など、Combo のスロットに配置するコンポーネントは別途登録してください。
その他のリソース
Web Components Single Selection Combo に関するその他のガイダンスとプロジェクト サポートについては、次のリソースを参照してください。
関連コンポーネント
Web Components Single Selection Combo は、ユーザーがリストを検索して 1 つのオプションを選択できるようにします。選択の動作が異なる場合は、次のコンポーネントを使用します。
- Combo - ユーザーが複数のオプションを選択する場合に Combo を使用します。
- Select - 検索が不要な短いリストから、ユーザーが 1 つのオプションを選ぶ場合に Select を使用します。
- Dropdown - ボタンやその他の要素からアクションまたはオプションのリストを表示する場合に Dropdown を使用します。
FAQ
これらの質問では、Web Components Single Selection Combo の一般的なセットアップ、選択、使用シナリオを取り上げます。
Web Components Combo で singleSelect を設定します。すると Combo は一度に 1 つの項目を選択し、ユーザーは入力フィールドに入力してリストをフィルタリングできます。ドロップダウンの検索入力とチェックボックスは非表示になります。
Web Components Combo の value に項目の valueKey の値を持つ配列を設定するか、項目を指定して select メソッドを呼び出します。valueKey がない場合、Web Components Combo は data 内のオブジェクトへの参照を使用します。
いいえ。Web Components Combo は data のオプションからのみ選択します。入力フィールドのテキストがどのオプションにも一致しない場合、Combo はフォーカスを失ったときに入力フィールドをクリアします。
Web Components Combo は、displayKey フィールド、または filteringOptions の filterKey でフィルタリングします。disableFiltering が設定されていないこと、およびそのキーがオプションのフィールドを指していることを確認してください。
リストが長く、ユーザーが入力して検索する必要がある場合は、Web Components Single Selection Combo を使用します。検索せずにオプションを選ぶ短いリストには、Web Components Select を使用します。