Componente Carrusel

El componente de carrusel de componentes principales permite al autor del contenido presentar el contenido en un carrusel navegable.

Uso

Con el componente Carrusel, el autor del contenido organizará el contenido en un carrusel giratorio de diapositivas.

El cuadro de diálogo de edición permite al autor de contenido crear, asignar nombres y ordenar varias diapositivas, así como habilitar la transición automática con retraso. Con el cuadro de diálogo de diseño, el autor de la plantilla puede definir qué componentes se pueden agregar al carrusel, habilitar o deshabilitar las transiciones automáticas y personalizar los estilos.

Versión y compatibilidad

La versión actual del componente Carrusel es la versión 1, que se introdujo con la versión 2.2.0 de los componentes principales en octubre de 2018 y se describe en este documento.

La siguiente tabla detalla todas las versiones compatibles del componente, las versiones de AEM con las que son compatibles las versiones del componente y los vínculos a la documentación de versiones anteriores.

Para obtener más información sobre las versiones y publicaciones de los componentes principales, consulte el documento Versiones de los componentes principales.

Salida del componente de ejemplo

Para experimentar el componente Carrusel, ver ejemplos de sus opciones de configuración y HTML y salida JSON, visite la Biblioteca de componentes.

Detalles técnicos

La documentación técnica más reciente sobre el componente Carrusel se encuentra en GitHub.

Puede encontrar más información sobre el desarrollo de componentes principales en la documentación para desarrolladores de componentes principales.

Vinculación profunda a un panel

Los componentes Carrusel, Pestañas y Acordeón admiten el enlace directo a un panel dentro del componente.

Para ello:

1. Visualice la página con el componente utilizando la opción Ver como publicado en el editor de páginas.
2. Inspeccione el contenido de la página e identifique el ID del panel.
   • Por ejemplo id="carousel-bfe4fa6647-item-47f1a7ca67-tabpanel"
3. El ID se convierte en el anclaje que puede anexar a la URL mediante un hash (#).
   • Por ejemplo https://wknd.site/content/wknd/language-masters/en/magazine/western-australia.html#carousel-bfe4fa6647-item-47f1a7ca67-tabpanel

Si se desplaza a la dirección URL con el ID de panel como anclaje, el explorador se desplazará directamente al componente en cuestión y mostrará el panel especificado. Si el panel está configurado para no mostrarse de forma predeterminada, se desplazará a automáticamente.

Cuadro de diálogo de edición

El cuadro de diálogo de edición permite al autor del contenido añadir, cambiar el nombre y reorganizar las diapositivas, así como definir la configuración de transición automática.

Pestaña Elementos

Utilice el botón Añadir para abrir el selector de componentes y elegir qué componente añadir como pestaña. Una vez añadida, se añade una entrada a la lista, que contiene las siguientes columnas:

• Icono: el icono del tipo de componente de la pestaña para facilitar la identificación en la lista. Pase el ratón por encima para ver el nombre completo del componente como información sobre herramientas.
• Descripción: la descripción utilizada como texto de la pestaña, de forma predeterminada, es el nombre del componente seleccionado para la pestaña.
• Eliminar: toque o haga clic para eliminar la pestaña del componente de pestañas.
• Reordenar: toque o haga clic y arrastre para ordenar las pestañas.

Pestaña Propiedades

En la pestaña Propiedades, el autor del contenido puede configurar la transición automática de las diapositivas.

• Elemento activo: el autor del contenido puede definir qué pestaña está activa cuando se carga la página.
• Transición automática de diapositivas: cuando esté activo, el componente avanzará automáticamente a la siguiente diapositiva después de un retraso especificado.
• Retraso de transición: cuando se selecciona la transición automática de diapositivas, este valor se utiliza para definir el retardo entre transiciones (en milisegundos).
• Deshabilitar la pausa automática al pasar el cursor: cuando se selecciona la transición automática de diapositivas, la transición de carrusel se pausa automáticamente cada vez que el cursor pasa el ratón sobre el carrusel. Seleccione esta opción para que la transición no se detenga.
• ID: esta opción permite controlar el identificador único del componente del HTML y de la capa de datos.
  • Si se deja en blanco, se generará automáticamente un ID único que se puede encontrar inspeccionando la página resultante.
  • Si se especifica un ID, es responsabilidad del autor asegurarse de que sea único.
  • Cambiar el ID puede afectar al seguimiento de CSS, JS y de la capa de datos.

Pestaña Accesibilidad

En la pestaña Accesibilidad, se pueden configurar valores para las etiquetas de accesibilidad ARIA del componente.

• Etiqueta: valor de un atributo de la etiqueta aria para el carrusel, el cual describe su contenido
• Anterior: valor de un atributo de la etiqueta aria para la etiqueta de botón anterior de la navegación del carrusel
• Siguiente: valor de un atributo de la etiqueta aria para la etiqueta de botón siguiente de la navegación del carrusel
• Reproducción: valor de un atributo de la etiqueta aria para la etiqueta del botón de reproducción de la navegación del carrusel
• Pausa: valor de un atributo de la etiqueta aria para la etiqueta del botón de pausa de la navegación del carrusel
• Lista de pestañas: valor de un atributo de la etiqueta aria para la etiqueta de lista de elementos de la navegación del carrusel
• Establecer la etiqueta aria del elemento en su título: si está activada, esta opción establece automáticamente el título de los elementos de carrusel en su descripción de la etiqueta aria.

Seleccionar panel

El autor del contenido puede utilizar la opción Seleccionar panel de la barra de herramientas de componentes para cambiar a una diapositiva diferente para editarla, así como para reorganizar fácilmente el orden de las diapositivas.

Una vez seleccionada la opción Seleccionar panel en la barra de herramientas de componentes, las diapositivas configuradas se muestran como una lista desplegable.

• La lista se ordena según la disposición asignada de las diapositivas y se refleja en la numeración.
• El tipo de componente de la diapositiva se muestra primero, seguido de la descripción de la diapositiva con la fuente más clara.

• Al tocar o hacer clic en una entrada de la lista desplegable, cambia la vista del editor a esa diapositiva.
• La diapositiva se puede reordenar mediante los controladores de arrastre.

Cuadro de diálogo de diseño

El cuadro de diálogo de diseño permite al autor de la plantilla definir qué componentes se pueden añadir como diapositivas al componente de carrusel, así como definir los valores predeterminados de transición automática y qué estilos personalizados están disponibles para el autor del contenido.

Pestaña Propiedades

La pestaña Propiedades se utiliza para definir la configuración predeterminada de las transiciones de diapositivas cuando un autor de contenido añade el componente de carrusel a una página.

• Diapositivas de transición automática: define si, de forma predeterminada, la opción para avanzar automáticamente el carrusel a la siguiente diapositiva está activada cuando el autor de contenido añade el componente de carrusel a una página.
• Prefijar elementos de control: si está activada, los elementos de control se colocan delante de los elementos del carrusel para mejorar la accesibilidad.

Pestaña Componentes permitidos

La pestaña Componentes permitidos se utiliza para definir qué componentes puede añadir el autor de contenido como diapositivas al componente de carrusel.

La pestaña Componentes permitidos funciona del mismo modo que la del mismo nombre cuando define la directiva y las propiedades de un contenedor de diseño en el Editor de plantillas.

Pestaña Estilos

El componente Carrusel es compatible con el sistema de estilos de AEM.

Capa de datos del cliente de Adobe

El componente Carrusel es compatible con la capa de datos del cliente de Adobe.

Recursos de Business.Adobe.com