Modelos de ComboBox

O componente Ignite UI for Angular ComboBox permite definir modelos personalizados para diferentes áreas, como cabeçalho, rodapé, itens, lista vazia e botão de adição.

Angular ComboBox Templates Example

Usage

Para começar com o componente ComboBox, primeiro você precisa importar oIgxComboModule conteúdo no seu arquivo app.module.ts:

import { IgxComboModule } from 'igniteui-angular/combo';
// import { IgxComboModule } from '@infragistics/igniteui-angular'; for licensed package

@NgModule({
    imports: [
        ...
        IgxComboModule,
        ...
    ]
})
export class AppModule {}

Template Types

Ao definir modelos de combobox, você precisa referenciá-los usando os seguintes nomes de referência predefinidos:

Item template

Use seletor[igxComboItem]:

<igx-combo #templateCombo [data]="lData" [valueKey]="'field'" >
    <ng-template igxComboItem let-display let-key="valueKey">
        <div class="item">
            <span class="state">{{ display[key] }}</span>
            <span class="region">{{ display.region }}</span>
        </div>
    </ng-template>
</igx-combo>

Header Item template

Use seletor[igxComboHeaderItem]:

<igx-combo #templateCombo [data]="lData" [groupKey]="'region'">
    <ng-template igxComboHeaderItem let-display let-key="groupKey">
        <div class="header-item">Region: {{ display[key] }}</div>
    </ng-template>
</igx-combo>

Header template

Use seletor[igxComboHeader]:

<igx-combo>
    <ng-template igxComboHeader>
        <div class="header-class">State - Region</div>
    </ng-template>
</igx-combo>

Use seletor[igxComboFooter]:

<igx-combo>
    <ng-template igxComboFooter>
        <div class="footer-class">Infragistics 2018</div>
    </ng-template>
</igx-combo>

Empty template

Use seletor[igxComboEmpty]:

<igx-combo>
    <ng-template igxComboEmpty>
        <span class="empty-class">No available states</span>
    </ng-template>
</igx-combo>

Add template

Use seletor[igxComboAddItem]:

<igx-combo>
    <ng-template igxComboAddItem>
        <button igxButton="flat">
            Add Location
        </button>
    </ng-template>
</igx-combo>

Toggle Icon Template

Use seletor[igxComboToggleIcon]:

<igx-combo>
    <ng-template igxComboToggleIcon let-collapsed>
        <igx-icon>{{ collapsed ? 'expand_more' : 'expand_less'}}</igx-icon>
    </ng-template>
</igx-combo>

Clear Icon Template

Use seletor[igxComboClearIcon]:

<igx-combo>
    <ng-template igxComboClearIcon>
        <igx-icon>cancel</igx-icon>
    </ng-template>
</igx-combo>

Templating ComboBox Input

Quando usados com templates, osigxComboClearIcon seletores eigxComboToggleIcon mudam como os respectivos botões aparecem na entrada da combobox. Passar conteúdo dentro de tambémigx-combo permite a templação da entrada combobox semelhante à forma como anigx-input-group pode ser templateado (usingigx-prefix,igx-suffix andigxLabel). O trecho de código abaixo ilustra como adicionar um rótulo e prefixo apropriados à entrada da combobox:

<igx-combo>
    <label igxLabel>Locations</label>
    <igx-prefix><igx-icon>pin_drop</igx-icon></igx-prefix>
</igx-combo>

API Summary

Additional Resources

Nossa comunidade é ativa e sempre acolhedora para novas ideias.