Blazor ComboBox Templates

    El componente Ignite UI for Blazor ComboBox permite definir plantillas personalizadas para diferentes áreas, como elementos, encabezados de grupo, listas vacías e iconos.

    ComboBox Templates Example

    EXAMPLE
    MODULES
    DATA
    RAZOR
    JS
    CSS

    Like this sample? Get access to our complete Ignite UI for Blazor toolkit and start building your own apps in minutes. Download it for free.

    Template Types

    Item Template

    itemTemplate es una plantilla personalizada que, si se define, debe usarse al representar elementos en la lista de opciones.

    Para crear una plantilla de los elementos en una aplicación Blazor, debe definir una plantilla en un archivo JavaScript independiente. Vamos a crear un nuevo archivo en el wwwroot directorio llamado templates.js.

    En este archivo podemos declarar una nueva plantilla de elemento así:

    Asegúrese de incluir el archivo templates.js en index.html en wwwroot.

    Luego, en nuestra aplicación podemos hacer referencia a la plantilla que declaramos mediante la propiedad ItemTemplateScript.

    <IgbCombo ItemTemplateScript="ComboItemTemplate"></IgbCombo>
    razor

    Group Header Template

    groupHeaderTemplate es una plantilla personalizada que, si se define, debe usarse al representar encabezados de grupo en la lista de opciones.

    Luego, en nuestra aplicación podemos hacer referencia a la plantilla que declaramos mediante la propiedad GroupHeaderTemplateScript.

    <IgbCombo GroupHeaderTemplateScript="ComboGroupHeaderTemplate"></IgbCombo>
    razor

    Slots

    Además de las plantillas personalizadas, el componente ComboBox de Ignite UI for Blazor expone varias ranuras que permiten a los usuarios pasar contenido personalizado a diferentes partes del combo.

    Header Slot

    Para representar un encabezado personalizado encima de la lista de opciones, pase el contenido a la ranura del header:

    <IgbCombo> 
        <header slot="header">
            Header content goes here
        </header>
    </IgbCombo>
    razor

    Para representar un pie de página personalizado debajo de la lista de opciones, pase el contenido a la ranura del pie footer:

    <IgbCombo> 
        <footer slot="footer">
            Footer content goes here
        </footer>
    </IgbCombo>
    razor

    Empty List Slot

    Para representar un contenido personalizado cuando la operación de filtrado no devuelve ningún resultado, utilice el espacio empty:

    <IgbCombo> 
        <div slot="empty">¯\_(ツ)_/¯</div>
    </IgbCombo>
    razor

    Toggle Icon Slot

    El ícono de alternancia en la entrada combinada también se puede modificar a través de la ranura toggle-icon:

    <IgbCombo> 
        <IgbIcon name="down" slot="toggle-icon"></IgbIcon>
    </IgbCombo>
    razor

    Clear Icon Slot

    El ícono de borrar se puede cambiar a través de la ranura clear-icon:

    <IgbCombo> 
        <IgbIcon name="clear" slot="clear-icon"></IgbIcon>
    </IgbCombo>
    razor

    Additional Resources