Componente Lista

El componente principal Lista permite crear fácilmente listas dinámicas y estáticas.

Uso

El componente Lista se puede utilizar para crear, por ejemplo, una lista dinámica de páginas secundarias o una estática de elementos definidos arbitrariamente. El autor de la plantilla puede definir el tipo de listas disponibles y las opciones de formato en el cuadro de diálogo de diseño. El editor de contenido puede seleccionar entre los tipos de lista disponibles y cómo dar formato a los elementos de la lista en el cuadro de diálogo de edición.

Versión y compatibilidad

La versión actual del componente Lista es la versión 4, que se introdujo con la versión 2.22.0 de los componentes principales en febrero de 2023 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.

Redirecciones en listas

Cuando una página tiene un objetivo de redirección (independientemente de si apunta a una dirección URL externa o a otra página de AEM), cualquier lista que contenga vínculos hacia ahí apunta directamente a la dirección URL del destino de redirección.

Ejemplo

• Cree una página A que redirija a la página B.
• Cree una página C que redirija a https://aemcomponents.dev
• En una página D, inserte un componente de lista que contenga las páginas A y C
• Los vínculos respectivos que se generan apuntan directamente a la página B y https://aemcomponents.dev

Salida del componente de ejemplo

Para visualizar el componente Lista, ver ejemplos de sus opciones de configuración, así como HTML y salida JSON, visite la Biblioteca de componentes.

Detalles técnicos

La documentación técnica más reciente sobre el componente Lista 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 configurar la lista y los elementos de la lista.

Pestaña de configuración de la lista

La lista se puede generar de diferentes maneras.

• Páginas secundarias
• Lista fija
• Búsqueda
• Etiquetas

Independientemente de cómo se genere la lista, hay Opciones de ordenación e ID que siempre se pueden configurar.

Según la forma en la que el autor del contenido elija crear la lista, las opciones de configuración adicionales cambiarán.

Páginas secundarias

La lista se puede crear a partir de las páginas secundarias de la página actual o de otra página.

• Página principal

  • La página cuyas páginas secundarias deben aparecer en la lista
  • Déjelo en blanco para utilizar la página actual

• Profundidad secundaria
  Cuántos niveles inferiores en la jerarquía deben usarse

Lista fija

La lista se puede crear mediante una lista fija de elementos.

Pulse o haga clic en el botón Añadir para insertar un nuevo elemento en la lista.

• En el campo Vínculo escriba
  • Una dirección URL completa
  • Una dirección URL relativa para el contenido de AEM existente
    • Puede usar el cuadro de diálogo Selección para elegir un elemento de AEM.
• En el campo Texto, escriba el texto que se mostrará para el vínculo en la lista.
• Marque la casilla de verificación si el vínculo debe abrirse en una nueva pestaña del explorador

Una vez creado más de un elemento para la lista, puede organizarla.

• Utilice el controlador de arrastre para reorganizar los elementos de la lista.
• Utilice el icono de la papelera para eliminar elementos de la lista.

Búsqueda

La lista se puede crear utilizando los resultados de una búsqueda de contenido de AEM.

• Consulta de búsqueda
  La cadena para la que se ejecutará una búsqueda de texto completo para generar los elementos de la lista
• Buscar en
  Dónde se debe ejecutar la búsqueda
  • Utilice el Cuadro de diálogo de selección para elegir la ubicación en AEM
  • Si se deja en blanco se usará la página actual

Etiquetas

La lista se puede crear utilizando páginas que coincidan con determinadas etiquetas en una ubicación concreta.

• Página principal
  Donde debería comenzar la coincidencia de etiquetas
  • Utilice el Cuadro de diálogo de selección para elegir la ubicación en AEM
  • Si se deja en blanco se usará la página actual
• Etiquetas
  Qué etiquetas deben coincidir
  • Utilice el cuadro de diálogo Examinar para seleccionar las etiquetas
• Coincidencias
  Define qué tipo de coincidencias debe presentar una página para incluirla en la lista
  • cualquier etiqueta
  • todas las etiquetas

Opciones de ordenación

Independientemente de cómo elija generar la lista, hay ciertas opciones de clasificación que siempre se pueden definir.

• Ordenar por
  Cómo se deben ordenar los elementos
  • Título
  • Fecha de la última modificación
• Orden de clasificación
  El orden en el que se deben ordenar los elementos
  • ascendente
  • descendente
• Artículos máximos
  Número máximo de elementos mostrados en la lista.
  • Déjelo vacío para ver todos los elementos.
• 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 de configuración de elementos

Con la pestaña Configuración de elementos, se puede configurar el formato de los elementos de la lista.

• Vincular elementos: vincular elementos a la página correspondiente
• Mostrar descripción: mostrar descripciones del elemento de vínculo
• Mostrar fecha: mostrar fecha de modificación del elemento vinculado
• Mostrar como teaser: cuando está marcado, el elemento se muestra como teaser

Pestaña Estilos

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

Utilice la lista desplegable para seleccionar los estilos que desea aplicar al componente. Las selecciones realizadas en el cuadro de diálogo de edición tienen el mismo efecto que las seleccionadas en la barra de herramientas de componentes.

Los estilos deben configurarse para este componente en el cuadro de diálogo de diseño para que el menú desplegable esté disponible.

Cuadro de diálogo de diseño

El cuadro de diálogo de diseño permite al autor de la plantilla definir qué tipos de listas se deben permitir a los autores de contenido, así como la configuración de elementos disponible.

Ajustes de la lista

En la pestaña Configuración de la lista, se puede definir el formato de fecha y qué tipo de listas deben estar disponibles en el componente para los autores de contenido.

• Formato de fecha:
  Formato que se usará para visualizar la fecha de la última modificación
• Deshabilitar elementos secundarios
  Deshabilitar el tipo de lista secundaria en el componente
• Deshabilitar estáticas
  Deshabilitar el tipo de lista estática en el componente
• Deshabilitar búsqueda
  Deshabilitar el tipo de lista de búsqueda en el componente
• Deshabilitar etiquetas
  Deshabilitar tipo de lista de etiquetas en el componente

Configuración del elemento

En la pestaña Configuración de elementos, se pueden definir las opciones de formato para los elementos de lista individuales que deben estar disponibles en el componente para los autores de contenido.

• Vincular elementos
  Habilitar vincular elementos en el cuadro de diálogo de edición
• Mostrar descripciones
  Habilitar la opción Mostrar descripciones en el cuadro de diálogo de edición
• Mostrar fecha
  Habilitar la opción Mostrar fecha en el cuadro de diálogo de edición

Pestaña Estilos

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

Capa de datos del cliente de Adobe

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

Recursos de Business.Adobe.com