Componente carrossel

O componente principal carrossel permite que o autor do conteúdo apresente conteúdo em um carrossel navegável.

Uso

Usando o componente Carrossel, o autor do conteúdo para organizar o conteúdo em um carrossel giratório de slides.

A caixa de diálogo de edição permite que o autor de conteúdo crie, nomeie e ordene vários slides, bem como habilite a transição automática com atraso. Usando a caixa de diálogo design, o autor do modelo pode definir quais componentes podem ser adicionados ao carrossel, ativar ou desativar transições automáticas e personalizar os estilos.

Versão e compatibilidade

A versão atual do componente carrossel é a v1, que foi introduzida com a versão 2.2.0 dos Componentes principais em outubro de 2018, e é descrita neste documento.

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

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

Saída de componente de exemplo

Para experimentar o componente carrossel e ver exemplos de suas opções de configuração, bem como a saída HTML e JSON, visite a Biblioteca de componentes.

Detalhes técnicos

A documentação técnica mais recente sobre o componente carrossel pode ser encontrada no GitHub.

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

Editar Caixa de Diálogo

A caixa de diálogo de edição permite que o autor de conteúdo adicione, renomeie e reorganize os slides, bem como definir as configurações de transição automática.

Guia Itens

Use o botão Adicionar para abrir o seletor de componentes e escolher qual componente adicionar como guia. Uma vez adicionada, uma entrada é adicionada à lista, que contém as seguintes colunas:

• Ícone - O ícone do tipo de componente da guia para facilitar a identificação na lista. Passe o mouse sobre o para ver o nome completo do componente como uma dica de ferramenta.
• Descrição - A descrição usada como o texto da guia, padronizando o nome do componente selecionado para a guia.
• Excluir - Toque ou clique para excluir a guia do componente de guias.
• Reordenar - Toque ou clique e arraste para ordenar as guias.

Guia Propriedades

Na guia Properties, o autor de conteúdo pode definir os slides para fazer a transição automática.

• Fazer a transição automática de slides - Quando ativo, o componente avança automaticamente para o próximo slide após um atraso especificado.
• Atraso de transição - Quando os slides de transição automática são selecionados, esse valor é usado para definir o atraso entre as transições (em milissegundos).
• Desativar a pausa automática ao passar o mouse - Quando a opção Fazer a transição automática de slidesis estiver selecionada, a transição do carrossel será automaticamente pausada sempre que o cursor passar o cursor sobre o carrossel. Selecione essa opção para que a transição não seja pausada.
• ID - Essa opção permite controlar o identificador exclusivo do componente no HTML e na Camada de dados.
  • Caso deixado em branco, uma ID exclusiva é gerada automaticamente para você e pode ser encontrada ao inspecionar a página resultante.
  • Se uma ID for especificada, é responsabilidade do autor garantir que seja exclusiva.
  • A alteração da ID pode afetar o rastreamento de CSS, JS e Camada de dados.

Guia Acessibilidade

Na guia Acessibilidade, os valores podem ser definidos para os rótulos de acessibilidade ARIA para o componente.

• Rótulo - Valor de um atributo de rótulo ARIA para o componente

Selecionar Painel

O autor de conteúdo pode usar a opção Selecionar painel na barra de ferramentas do componente para alterar para um slide diferente para edição, bem como para reorganizar facilmente a ordem dos slides.

Depois de selecionar a opção Selecionar painel na barra de ferramentas do componente, os slides configurados são exibidos como uma lista suspensa.

• A lista é ordenada pela disposição atribuída dos slides e é refletida na numeração.
• O tipo de componente do slide é exibido primeiro, seguido pela descrição do slide com fonte mais clara.

• Tocar ou clicar em uma entrada na lista suspensa altera a exibição do editor para esse slide.
• O slide pode ser reordenado no local usando as alças de arrastar.

Caixa de diálogo Design

A caixa de diálogo de design permite que o autor do modelo defina quais componentes podem ser adicionados como slides ao componente do carrossel, bem como definir padrões de transição automática e quais estilos personalizados estão disponíveis para o autor de conteúdo.

Guia Propriedades

A guia Properties é usada para definir as configurações padrão para as transições de slide quando um autor de conteúdo adiciona o componente de carrossel a uma página.

• Fazer a transição automática de slides - Define se, por padrão, a opção de avançar automaticamente o carrossel para o próximo slide é ativada quando o autor de conteúdo adiciona o componente do carrossel a uma página.
• Atraso de transição - Define o valor padrão do atraso de transição entre os slides (em milissegundos) quando um autor de conteúdo adiciona o componente de carrossel a uma página.
• Desativar a pausa automática ao passar o mouse - Define se, por padrão, a opção para desativar a pausa automática de slide é ativada quando a opção Fazer a transição automática de slidesis é selecionada pelo autor de conteúdo.

Guia Componentes permitidos

A guia Componentes permitidos é usada para definir quais componentes podem ser adicionados como slides ao Componente de carrossel pelo autor de conteúdo.

A guia Componentes permitidos funciona da mesma maneira que a guia do mesmo nome ao definir a política e as propriedades de um Contêiner de layout no Editor de modelo.

Guia Estilos

O componente carrossel suporta o AEM Style System.

Camada de dados do cliente Adobe

O componente carrossel suporta a Camada de Dados do Cliente Adobe.