Componente de Lista

O componente de Lista, dos Componentes principais, permite criar com facilidade listas dinâmicas e estáticas.

Uso

O componente de Lista pode ser usado para criar, por exemplo, uma lista dinâmica de páginas secundárias ou uma lista estática de itens definidos arbitrariamente. O tipo de listas disponíveis e as opções de formatação podem ser definidas pelo autor do modelo na caixa de diálogo de design. O editor de conteúdo pode selecionar dentre os tipos de lista disponíveis e escolher como formatar os elementos da lista na caixa de diálogo de edição.

Versão e compatibilidade

A versão atual do Componente de lista é a v4, introduzida com a versão 2.22.0 dos Componentes principais em fevereiro de 2023, e está descrita neste documento.

A tabela a seguir detalha todas as versões compatíveis do componente, as versões do AEM com as quais as versões do componente são compatíveis e os links para a documentação das versões anteriores.

Para mais informações sobre as versões dos Componentes principais, consulte o documento Versões dos Componentes principais.

Redirecionamentos em listas

Quando uma página tem um destino de redirecionamento (independentemente de estar apontando para um URL externo ou para outra página do AEM), uma lista que contém links para ele, aponta diretamente para o URL do destino de redirecionamento.

Exemplo

• Crie uma página A que redirecione para a página B.
• Crie uma página C que redireciona para https://aemcomponents.dev
• Em uma página D, insira um componente de lista que contenha as páginas A e C
• Os respectivos links que são gerados, apontam diretamente para a página B e https://aemcomponents.dev

Exemplo de saída do componente

Para experimentar o componente de Lista, e ver exemplos de suas opções de configuração e de saídas HTML e JSON, visite a Biblioteca de Componentes.

Detalhes técnicos

A documentação técnica mais recente sobre o Componente de Lista pode ser encontrada no GitHub.

Mais detalhes sobre o desenvolvimento dos Componentes principais podem ser encontrados na documentação do desenvolvedor dos Componentes principais.

Caixa de diálogo de edição

A caixa de diálogo de edição permite que o autor de conteúdo configure a lista e os itens da lista.

Guia Configurações de lista

A lista pode ser criada de maneiras diferentes.

• Páginas secundárias
• Lista fixa
• Pesquisar
• Tags

Independentemente de como a lista seja criada, há Opções de Classificação e ID que sempre podem ser configuradas.

Dependendo de como o autor de conteúdo optar por criar a lista, as opções de configuração adicionais serão alteradas.

Páginas secundárias

A lista pode ser criada das páginas secundárias da página atual ou de outra página.

• Página primária

  • A página cujas páginas secundárias devem fazer a lista
  • Deixe em branco para utilizar a página atual

• Profundidade-secundária
  Quantos níveis abaixo da hierarquia devem ser usados

Lista fixa

A lista pode ser criada usando uma lista fixa de itens.

Toque ou clique no botão Adicionar para inserir um novo item à lista.

• No campo Link insira:
  • Um URL totalmente qualificado
  • Um URL relativo para um conteúdo AEM já existente
    • Você pode usar a Caixa de diálogo de seleção para escolher um item do AEM.
• No campo Texto, insira o texto que será exibido para o link na lista.
• Marque a caixa de seleção se o link deve abrir em uma nova guia do navegador

Após a criação de mais de um item para a lista, é possível organizá-la.

• Use a alça de arrastar para reorganizar os itens na lista.
• Use o ícone da lixeira para excluir itens na lista.

Pesquisar

A lista pode ser criada usando os resultados de uma pesquisa de conteúdo AEM.

• Pesquisar consulta
  A sequência de caracteres para a qual uma pesquisa de texto completo será executada para gerar os elementos da lista
• Pesquisar em
  Onde a pesquisa deve ser executada
  • Use a caixa de diálogo de seleção para escolher o local no AEM
  • Use página atual se deixado em branco

Tags

A lista pode ser criada usando páginas que correspondem a determinadas tags em um determinado local.

• Página principal
  Onde a correspondência de tags deve começar
  • Use a caixa de diálogo de seleção para escolher o local no AEM
  • Use página atual se deixado em branco
• Tags
  Quais tags devem ser correspondidas
  • Use a caixa de diálogo Procurar para selecionar as tags
• Correspondência
  Define que tipo de correspondência deve qualificar uma página a ser incluída na lista
  • qualquer tag
  • todas as tags

Opções de classificação

Independentemente de como você optar por criar a lista, há certas opções de classificação que sempre podem ser definidas.

• Ordenar por
  Como os elementos devem ser ordenados
  • Título
  • Última data de modificação
• Ordem de classificação
  A ordem na qual os itens devem ser ordenados
  • ascendente
  • descendente
• Número máximo de itens - Número máximo de itens exibidos na lista.
  • Deixe em branco para retornar todos os itens.
• ID - Essa opção permite controlar o identificador exclusivo do componente no HTML e na Camada de Dados.
  • Caso deixado em branco, um ID exclusivo é gerado automaticamente para você e pode ser encontrado ao inspecionar a página resultante.
  • Se um ID for especificado, é responsabilidade do autor garantir que ele seja exclusivo.
  • A alteração do ID pode afetar o rastreamento de CSS, JS e da Camada de Dados.

Guia Configurações de itens

Usando a guia Configurações de item, a formatação dos elementos da lista pode ser configurada.

• Vincular itens - Vincula itens à página correspondente.
• Mostrar descrição - Mostra descrições do item de link
• Mostrar data - Mostra a data de modificação do item de link.
• Exibir como teaser - Quando marcada, o item é exibido como um teaser

Guia Estilos

O componente de lista é compatível com o sistema de estilos do AEM.

Use o menu suspenso para selecionar os estilos que deseja aplicar ao componente. As seleções feitas na caixa de diálogo de edição têm o mesmo efeito das selecionadas na barra de ferramentas do componente.

Os estilos devem ser configurados para esse componente na caixa de diálogo de design para que o menu suspenso fique disponível.

Caixa de diálogo de design

A caixa de diálogo de design permite que o autor do modelo defina quais tipos de listas devem ser liberadas para os autores de conteúdo, bem como as configurações de item disponíveis.

Configurações da lista

Na guia Configurações da lista, o formato da data pode ser definido, bem como o tipo de listas que deve estar disponível no componente para os autores de conteúdo.

• Formato da data - Formato a ser usado na exibição da última data de modificação.
• Desativar secundárias
  Desativa o tipo de listas secundárias no componente.
• Desativar estática
  Desativa o tipo de lista estática no componente.
• Desativar pesquisa
  Desativa o tipo de lista de pesquisa no componente.
• Desativar tags
  Desativa o tipo de lista de tags no componente.

Configurações do item

Na guia Configurações do item, as opções de formatação para os elementos da lista individual que devem estar disponíveis no componente para os autores de conteúdo podem ser definidas.

• Vincular itens
  Habilita a opção Vincular itens na caixa de diálogo de edição.
• Mostrar descrições
  Habilita a opção Mostrar descrições na caixa de diálogo de edição.
• Mostrar data
  Habilita a opção Mostrar data na caixa de diálogo de edição.

Guia Estilos

O componente de Imagem é compatível com o Sistema de Estilos do AEM.

Camada de dados de clientes Adobe

O componente de lista oferece suporte à Camada de dados de clientes Adobe.