Web Components ComboBox Features

    Ignite UI for Web Components ComboBox 구성 요소는 필터링 및 그룹화와 같은 여러 기능을 노출합니다.

    Combobox Features Example

    다음 데모는 런타임 시 활성화/비활성화되는 일부 ComboBox 기능을 보여줍니다.

    샘플에서는 IgcSwitchComponent 구성 요소를 사용할 것이므로 콤보와 함께 등록해야 합니다.

    import { defineComponents, IgcComboComponent, IgcSwitchComponent } from 'igniteui-webcomponents';
import 'igniteui-webcomponents/themes/light/bootstrap.css';

defineComponents(IgcComboComponent, IgcSwitchComponent);

    let combo = document.getElementById('combo') as IgcComboComponent<City>;

let switchIcon = document.getElementById('caseSensitive') as IgcSwitchComponent;
let switchFilter = document.getElementById('filtering') as IgcSwitchComponent;
let switchDisable = document.getElementById('disabled') as IgcSwitchComponent;

switchIcon.addEventListener("igcChange", () => {
    combo.caseSensitiveIcon = switchIcon.checked;
});

switchFilter.addEventListener("igcChange", () => {
    combo.disableFiltering = switchIcon.disabled = switchFilter.checked;
});

switchDisable.addEventListener("igcChange", () => {
    combo.disabled = switchDisable.checked;
});

    ​groupKey 속성을 해당 데이터 소스 필드로 설정하여 그룹화를 활성화/비활성화합니다.

    let switchGroup = document.getElementById('grouping') as IgcSwitchComponent;

switchGroup.addEventListener("igcChange", () => {
    this.combo.groupKey = switchGroup.checked ? "country" : undefined;
});

    특징

    필터링

    기본적으로 ComboBox의 필터링은 활성화되어 있습니다. disableFiltering 속성을 설정하여 비활성화할 수 있습니다.

    검색 대소문자 구분을 활성화하면 필터링 옵션이 더욱 향상될 수 있습니다. 최종 사용자가 대소문자 구분을 제어할 수 있도록 caseSensitiveIcon 속성을 사용하여 대소문자 구분 아이콘을 설정할 수 있습니다.

    <igc-combo disable-filtering case-sensitive-icon></igc-combo>

    필터링 옵션

    Ignite UI for Web Components ComboBox 구성 요소는 FilterKey 및 CaseSensitive 옵션 모두의 구성을 전달할 수 있는 필터링 속성을 하나 더 공개합니다. FilterKey는 옵션 목록을 필터링하는 데 사용해야 하는 데이터 소스 필드를 나타냅니다. CaseSensitive 옵션은 필터링이 대소문자를 구분해야 하는지 여부를 나타냅니다.

    다음 코드 조각은 이름 대신 국가별로 데이터 소스의 도시를 필터링하는 방법을 보여줍니다. 또한 기본적으로 필터링에서 대소문자를 구분하도록 설정하고 있습니다.

    const options = {
    filterKey: 'country',
    caseSensitive: true
};

combo.filteringOptions = options;

    Grouping

    ​groupKey 옵션을 정의하면 제공된 키에 따라 항목이 그룹화됩니다.

    <igc-combo group-key="region"></igc-combo>

    [!Note] The groupKey property will only have effect if your data source consists of complex objects.

    정렬 방향

    ComboBox 구성 요소는 그룹을 오름차순으로 정렬해야 하는지 내림차순으로 정렬해야 하는지 설정하는 옵션도 제공합니다. 기본적으로 정렬 순서는 오름차순입니다.

    <igc-combo group-sorting="desc"></igc-combo>

    Label

    ​IgcComboComponent 라벨은 label 속성을 사용하여 쉽게 설정할 수 있습니다.

    <igc-combo label="Cities"></igc-combo>

    Placeholder

    ComboBox 구성 요소 입력과 드롭다운 메뉴 내에 있는 검색 입력 모두에 대해 자리 표시자 텍스트를 지정할 수 있습니다.

    <igc-combo placeholder="Pick a city" placeholder-search="Search for a city"></igc-combo>

    Autofocus

    페이지 로드 시 ComboBox에 자동으로 초점을 맞추려면 다음 코드를 사용할 수 있습니다.

    <igc-combo autofocus></igc-combo>

    Search Input Focus

    ComboBox 검색 입력은 기본적으로 초점이 맞춰져 있습니다. 이 기능을 비활성화하고 옵션 목록으로 포커스를 이동하려면 아래와 같이 autofocusList 속성을 사용하십시오.

    <igc-combo autofocus-list></igc-combo>

    Required

    필수 속성을 설정하여 ComboBox를 필수로 표시할 수 있습니다.

    <igc-combo required></igc-combo>

    Disable ComboBox

    ​disabled 속성을 사용하여 ComboBox를 비활성화할 수 있습니다.

    <igc-combo disabled></igc-combo>

    API Reference

    Additional Resources