Plantillas de cuadros combinados
La Ignite UI for Angular ComboBox permite definir plantillas personalizadas para diferentes áreas, como encabezado, pie de página, elementos, lista vacía y botón para agregar.
Angular ComboBox Templates Example
Usage
Para comenzar con el componente ComboBox, primero debe importar IgxComboModule
en su archivo app.module.ts:
import { IgxComboModule } from 'igniteui-angular';
// import { IgxComboModule } from '@infragistics/igniteui-angular'; for licensed package
@NgModule({
imports: [
...
IgxComboModule,
...
]
})
export class AppModule {}
Template Types
Al definir plantillas de cuadros combinados, debe hacer referencia a ellas utilizando los siguientes nombres de referencia predefinidos:
Item template
Utilice el selector [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
Utilice el selector [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
Utilice el selector [igxComboHeader]
:
<igx-combo>
<ng-template igxComboHeader>
<div class="header-class">State - Region</div>
</ng-template>
</igx-combo>
Footer template
Utilice el selector [igxComboFooter]
:
<igx-combo>
<ng-template igxComboFooter>
<div class="footer-class">Infragistics 2018</div>
</ng-template>
</igx-combo>
Empty template
Utilice el selector [igxComboEmpty]
:
<igx-combo>
<ng-template igxComboEmpty>
<span class="empty-class">No available states</span>
</ng-template>
</igx-combo>
Add template
Utilice el selector [igxComboAddItem]
:
<igx-combo>
<ng-template igxComboAddItem>
<button igxButton="flat">
Add Location
</button>
</ng-template>
</igx-combo>
Toggle Icon Template
Utilice el selector [igxComboToggleIcon]
:
<igx-combo>
<ng-template igxComboToggleIcon let-collapsed>
<igx-icon>{{ collapsed ? 'expand_more' : 'expand_less'}}</igx-icon>
</ng-template>
</igx-combo>
Clear Icon Template
Utilice el selector [igxComboClearIcon]
:
<igx-combo>
<ng-template igxComboClearIcon>
<igx-icon>cancel</igx-icon>
</ng-template>
</igx-combo>
Templating ComboBox Input
Cuando se usan con plantillas, los selectores igxComboClearIcon
y igxComboToggleIcon
, cambian la forma en que aparecen los botones respectivos en la entrada del cuadro combinado. Pasar contenido dentro del igx-combo
también permite crear plantillas para la entrada del cuadro combinado de manera similar a la forma en que se puede crear una plantilla para un igx-input-group
(usando igx-prefix
, igx-suffix
e igxLabel
). El siguiente fragmento de código ilustra cómo agregar una etiqueta y un prefijo apropiados a la entrada del cuadro combinado:
<igx-combo>
<label igxLabel>Locations</label>
<igx-prefix><igx-icon>pin_drop</igx-icon></igx-prefix>
</igx-combo>
API Summary
Additional Resources
- Componente de cuadro combinado
- Funciones del cuadro combinado
- Enlace remoto de ComboBox
- Integración de formularios basados en plantillas
- Integración de formularios reactivos
- Cuadro combinado de selección única
Nuestra comunidad es activa y siempre da la bienvenida a nuevas ideas.