Descripción general del panel de expansión React
La Ignite UI for React 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.
React Expansion Panel Example
Usage
Primero, debe instalar el paquete Ignite UI for React npm correspondiente ejecutando el siguiente comando:
npm install igniteui-react
Luego necesitarás importar IgrExpansionPanel, su CSS necesario y registrar su módulo, así:
import { IgrExpansionPanel, IgrExpansionPanelModule } from 'igniteui-react';
import 'igniteui-webcomponents/themes/light/bootstrap.css';
IgrExpansionPanelModule.register();
La forma más sencilla de empezar a utilizar IgrExpansionPanel es la siguiente:
<IgrExpansionPanel>
<h1 slot="title">Golden Retriever</h1>
<h3 slot="subtitle">Medium-large gun dog</h3>
<span>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 breeds 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.</span>
</IgrExpansionPanel>
Binding to events
El componente Panel de expansión genera los siguientes eventos:
- Cerrado: elevado cuando el panel de expansión está plegado
- Abierto: elevado cuando se expande el panel de expansión
- Cerrando - Levantado cuando el panel de expansión comienza a colapsar
- Apertura: elevada 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 eventos Opened y Closed:
Component Customization
El control IgrExpansionPanel permite agregar todo tipo de contenido dentro de su cuerpo. ¡Puede representar entradas, gráficos e incluso otros paneles de expansión!
IgrExpansionPanel 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 Ignite UI for React 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 Ignite UI for React Expansion Panel expone varias partes CSS (header, indicator, title, subtitle y content) para brindarle control total sobre su estilo.