Descripción general del panel de expansión de Web Components

    El panel de expansión Ignite UI for Web Components es un componente de acordeón liviano que se puede renderizar en dos estados: contraído o expandido. El panel de expansión se puede alternar con un clic del mouse o interacciones con el teclado.

    Ejemplo de panel de expansión Web Components

    EXAMPLE
    TS
    HTML
    ExpansionPanelUsage.css
    index.css

    ¿Te gusta esta muestra? Obtenga acceso a nuestro kit de herramientas de Ignite UI for Web Components completo y comience a crear sus propias aplicaciones en minutos. Descárgalo gratis.

    Uso

    En primer lugar, debe instalar el Ignite UI for Web Components ejecutando el siguiente comando:

    npm install igniteui-webcomponents
    cmd

    Antes de utilizar IgcExpansionPanelComponent, debe registrarlo de la siguiente manera:

    import {defineComponents, IgcExpansionPanelComponent} from 'igniteui-webcomponents';
    
    defineComponents(IgcExpansionPanelComponent);
    ts

    Para obtener una introducción completa a Ignite UI for Web Components, lea el tema Primeros pasos.

    La forma más sencilla de empezar a utilizar IgcExpansionPanelComponent es la siguiente:

    <igc-expansion-panel>
        <div slot="title">Golden Retriever</div>
        <div slot="subTitle">Medium-large gun dog</div>
        <div>
            <p>The Golden Retriever is a medium-large gun dog that retrieves shot waterfowl, such as ducks
            and upland game birds, during hunting and shooting parties.[3] The name "retriever" refers to the breed's ability
            to retrieve shot game undamaged due to their soft mouth. Golden retrievers have an instinctive love of water, and
            are easy to train to basic or advanced obedience standards.</p>
        </div>
    </igc-expansion-panel>
    html
    Ignite UI for Web Components | CTA Banner

    Vinculación a eventos

    El componente Panel de expansión genera los siguientes eventos:

    • igcClosed: se eleva cuando el panel de expansión está plegado
    • igcOpened: elevado cuando se expande el panel de expansión
    • igcClosing: se eleva cuando el panel de expansión comienza a colapsar
    • igcOpening: aumenta cuando el panel de expansión comienza a expandirse

    El siguiente ejemplo demuestra cómo podemos agregar algo de lógica a nuestro componente para que muestre/oculte el subtitle según el estado actual del panel.

    Podemos hacer esto vinculando los emisores de eventos igcOpened e igcClosed:

    EXAMPLE
    TS
    HTML
    ExpansionPanelPropertiesAndEvents.css
    index.css

    Personalización de componentes

    El control IgcExpansionPanelComponent permite agregar todo tipo de contenido dentro de su cuerpo. ¡Puede representar entradas, gráficos e incluso otros paneles de expansión!

    El IgcExpansionPanelComponent permite una fácil personalización del encabezado a través de las ranuras expuestas de título, subtítulo e indicador.

    La configuración de la posición del indicador de expansión se puede realizar a través de la indicatorPosition propiedad del Panel de expansión. Las opciones posibles son inicio, fin o ninguna.

    El siguiente ejemplo de código demuestra cómo configurar el botón del componente para que vaya al lado derecho.

    EXAMPLE
    TS
    HTML
    ExpansionPanelCustomization.css
    index.css

    Navegación por teclado

    La navegación por teclado del panel de expansión Ignite UI for Web Components cumple con los estándares de accesibilidad del W3C y es cómoda de usar.

    Combinaciones de teclas

    • Alt + ↓: expande el panel enfocado
    • Alt + ↑: contrae el panel enfocado
    • Espacio / Entrar: alterna el estado de expansión del panel enfocado

    Estilo

    El componente Panel de expansión Ignite UI for Web Components expone varias partes CSS (header, indicator, title,y subtitle​ ​content) para proporcionar un control total sobre su estilo.

    EXAMPLE
    TS
    HTML
    ExpansionPanelStyling.css
    index.css

    Referencias de API

    Recursos adicionales