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.

Versión del componente AEM 6.4 AEM 6.5 AEM as a Cloud Service
Versión 1 Compatible Compatible Compatible

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.

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

Pestaña Elementos del cuadro de diálogo de edición del componente Carrusel

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.
SUGERENCIA

Si la ventana móvil de la página se reduce para que el cuadro de diálogo de edición pase a estar en pantalla completa, el botón Añadir se ocultará. Los componentes se pueden añadir al componente de carrusel arrastrando desde el explorador de componentes y soltando en el componente de carrusel en el editor de páginas.

Pestaña Propiedades

Pestaña Propiedades del cuadro de diálogo de edición del componente Carrusel

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

  • 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.
NOTA

Los controles avanzados de diapositivas no están activados en el modo Editar. Utilice el modo Vista previa o la opción Ver como publicado para interactuar con el carrusel como lo haría un lector del contenido publicado.

La función de avance automático no está habilitada cuando se encuentra en modo Editar. Utilice la opción Ver como publicado para ver la función de avance automático como lo haría un lector del contenido publicado.

Pestaña Accesibilidad

Pestaña Accesibilidad del cuadro de diálogo de edición del componente Carrusel

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

  • Etiqueta: valor de un atributo de etiqueta ARIA para el componente

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.

Icono Seleccionar panel

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.

Seleccionar el panel

  • 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.

Cuadro de diálogo de diseño del componente Carrusel

  • 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.
  • Retraso de transición: define el valor predeterminado del retraso de la transición entre diapositivas (en milisegundos) cuando un autor de contenido añade el componente de carrusel a una página.
  • Deshabilitar la pausa automática al pasar el cursor: define si, de forma predeterminada, la opción para deshabilitar la pausa automática de la diapositiva está habilitada cuando el autor de contenido selecciona la Transición automática de las diapositivas.

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.

En esta página