Descripción general del panel de expansión Web Components
El panel de expansión Ignite UI for Web Components es un componente de acordeón liviano que se puede representar en dos estados: contraído o expandido. El panel de expansión se puede alternar mediante un clic del mouse o interacciones con el teclado.
Web Components Expansion Panel Example
Usage
Primero, debe instalar la Ignite UI for Web Components ejecutando el siguiente comando:
npm install igniteui-webcomponents
Antes de utilizar IgcExpansionPanelComponent, debe registrarlo de la siguiente manera:
import {defineComponents, IgcExpansionPanelComponent} from 'igniteui-webcomponents';
defineComponents(IgcExpansionPanelComponent);
Para obtener una introducción completa a Ignite UI for Web Components, lea el tema Introducción.
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>
Binding to events
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:
Component Customization
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.
Keyboard Navigation
La navegación con teclado del panel de expansión Ignite UI for Web Components cumple con los estándares de accesibilidad 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
Styling
El componente Panel de expansión Ignite UI for Web Components expone varias partes CSS (header, indicator, title, subtitle y content) para brindarle control total sobre su estilo.