Componente de lista

El componente de Lista de componentes principales 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 lista estática de elementos definidos arbitrariamente. El tipo de listas disponibles y las opciones de formato pueden ser definidas por el autor de la plantilla 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 lista en el cuadro de diálogo de edición.

Versión y compatibilidad

La versión actual del componente de Lista es v2, que se introdujo con la versión 2.0.0 de los componentes principales en enero de 2018, y se describe en este documento.

En la tabla siguiente se detallan todas las versiones compatibles del componente, las versiones 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
v2 Compatible Compatible Compatible
v1 Compatible Compatible -

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

Salida de componente de muestra

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

Detalles técnicos

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

Encontrará más detalles sobre el desarrollo de los componentes principales en la documentación para desarrolladores de los componentes principales.

Editar cuadro de diálogo

El cuadro de diálogo de edición permite al autor del contenido configurar la lista y los elementos de lista.

Ficha Configuración de lista

La lista se puede construir de diferentes maneras.

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

Cuadro de diálogo de edición del componente de lista

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

Páginas secundarias

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

Opciones de página secundarias

  • Página principal

    • La página cuyas páginas secundarias deben realizar la lista
    • Deje en blanco para utilizar la página actual
  • Profundidad secundaria
    Cuántos niveles inferiores de la jerarquía se deben utilizar

Lista fija

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

Opciones de lista fijas

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

  • Escriba el texto del elemento en la lista o utilice el Cuadro de diálogo de selección para elegir un elemento de AEM.
  • Utilice el controlador de arrastre para reorganizar los elementos de la lista.
  • Utilice el icono de papelera para eliminar elementos de la lista.

Búsqueda

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

Opciones de lista de búsqueda

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

Etiquetas

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

Opciones de lista de etiquetas

  • Página principal
    Dónde debe inicio la coincidencia de etiquetas
    • Utilice el Cuadro de diálogo de selección para elegir la ubicación en AEM
    • Usar la página actual si se deja en blanco

  • EtiquetasQué etiquetas deben coincidir
    • Utilice el cuadro de diálogo Examinar para seleccionar las etiquetas

  • CoincidenciaDefina qué tipo de coincidencia debe calificar una página para incluirla en la lista
    • cualquier etiqueta
    • todas las etiquetas

Opciones de ordenación

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

Opciones de ordenación

  • Ordenar
    porCómo se deben ordenar los elementos
    • Título
    • Fecha de la última modificación
  • Orden
    de clasificaciónEl orden en el que se deben ordenar los elementos
    • ascendente
    • descendente
  • Número máximo
    de elementosNúmero máximo de elementos mostrados en la lista.
    • Deje vacío para devolver todos los elementos.
  • ID : Esta opción permite controlar el identificador único del componente en el HTML y en la capa de datos.
    • Si se deja en blanco, se genera automáticamente una ID única para usted y 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 tener un impacto en el seguimiento de CSS, JS y de la capa de datos.

Ficha Configuración de elemento

Mediante la ficha Configuración de elemento, se puede configurar el formato de los elementos de lista.

Configuración del elemento

  • Vincular
    elementosVincular elementos a la página correspondiente
  • Mostrar
    descripciónMostrar descripciones del elemento de vínculo
  • Mostrar
    fecha Mostrar fecha de modificación del elemento de vínculo

Diálogo de diseño

El cuadro de diálogo de diseño permite al autor de la plantilla definir los tipos de listas que deben permitirse a los autores de contenido, así como la configuración del elemento disponible.

Ajustes de la lista

En la ficha Configuración de Lista, se puede definir el formato de fecha, así como el tipo de listas que deben estar disponibles en el componente para los autores de contenido.

Configuración de la lista del cuadro de diálogo de diseño del componente de lista

  • Date
    FormatFormat que se usará para mostrar la fecha de la última modificación
  • Deshabilitar
    elementos secundariosDeshabilitar el tipo de lista secundarios en el componente
  • Deshabilitar
    staticDeshabilitar el tipo de lista estática en el componente
  • Deshabilitar la
    búsquedaDeshabilitar el tipo de lista de búsqueda en el componente
  • Deshabilitar
    etiquetasDeshabilitar el tipo de lista de etiquetas en el componente

Ajustes del elemento

En la ficha Configuración del elemento, 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.

Configuración del elemento del cuadro de diálogo de diseño del componente de lista

  • Vincular
    elementosHabilitar elementos de vínculo en el cuadro de diálogo Editar
  • Mostrar
    descripcionesActivar la opción Mostrar descripciones en el cuadro de diálogo Editar
  • Mostrar
    fechaActivar la opción Mostrar fecha en el cuadro de diálogo Editar

Ficha Estilos

El componente Imagen admite el sistema de estilo AEM .

En esta página