Componente Carrossel carousel-component
O componente Carrossel, dos Componentes principais, permite que o autor do conteúdo apresente conteúdo em um carrossel navegável.
Uso usage
Com o componente Carrossel, o autor do conteúdo pode 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 e habilite a transição automática com atraso. Usando a caixa de diálogo de 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 version-and-compatibility
A versão atual do componente Carrossel é a v1, introduzida com a versão 2.2.0 dos Componentes principais em outubro de 2018, 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.
Exemplo de saída do componente sample-component-output
Para experimentar o componente Carrossel, 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 technical-details
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.
Deep linking para um painel deep-linking
Os componentes de Carrossel, Guias e Acordeão podem ser vinculados diretamente a um painel do componente.
Para fazer isso:
- Visualize a página com o componente usando a opção Exibir como publicada no editor de páginas.
- Inspecione o conteúdo da página e identifique o ID do painel.
- Por exemplo
id="carousel-bfe4fa6647-item-47f1a7ca67-tabpanel"
- Por exemplo
- O ID se torna a âncora que pode ser anexada ao URL usando um hash (
#).- Por exemplo
https://wknd.site/content/wknd/language-masters/en/magazine/western-australia.html#carousel-bfe4fa6647-item-47f1a7ca67-tabpanel
- Por exemplo
Ao navegar até o URL com o ID do painel como âncora, o navegador rolará diretamente para o componente específico e exibirá o painel especificado. Se o painel estiver configurado para não ser exibido por padrão, a tela será rolada automaticamente até que ele esteja visível.
Carrossel e design responsivo responsive-design
Todos os Componentes principais foram projetados para serem totalmente responsivos, garantindo uma experiência perfeita em todos os dispositivos.
Alguns componentes avançados, como o componente Carrossel, podem exigir uma consideração específica no contexto do projeto no qual é implementado para manter a capacidade de resposta em todas as condições. Consulte o documento Design responsivo dos componentes principais para obter mais informações.
Caixa de diálogo de edição edit-dialog
A caixa de diálogo de edição permite que o autor de conteúdo adicione, renomeie e reorganize os slides e defina as configurações de transição automática.
Guia Itens items-tab
Use o botão Adicionar para abrir o seletor de componentes e escolher que componente adicionar como guia. Uma vez adicionado, uma entrada é adicionada à lista, contendo as seguintes colunas:
- Ícone - O ícone do tipo de componente da guia para facilitar a identificação na lista. Passe o mouse sobre o ícone 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 properties-tab
Na guia Propriedades, o autor de conteúdo pode definir os slides para fazer a transição automática.
-
Item ativo - O autor de conteúdo pode definir qual guia está ativa quando a página é carregada.
-
Fazer 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 Fazer transição automática de slides é selecionado, esse valor é usado para definir o atraso entre as transições (em milissegundos).
-
Desativar a pausa automática ao passar o cursor - Quando a opção Fazer transição automática de slides estiver selecionado, a transição do carrossel será automaticamente pausada sempre que cursor for passado 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, 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 Acessibilidade accessibility-tab
Na guia Acessibilidade, os valores podem ser definidos para rótulos de acessibilidade ARIA para o componente.
- Rótulo - Valor de um atributo de rótulo ARIA do carrossel, o qual descreve o seu conteúdo.
- Anterior - Valor de um atributo de rótulo ARIA do rótulo do botão “Anterior” da navegação do carrossel.
- Próximo - Valor de um atributo de rótulo ARIA do rótulo do botão “Próximo” da navegação do carrossel
- Reproduzir - Valor de um atributo de rótulo ARIA do rótulo do botão “Reproduzir” da navegação do carrossel
- Pausar - Valor de um atributo de rótulo ARIA do rótulo do botão “Pausar” da navegação do carrossel
- Lista de guias - Valor de um atributo de rótulo ARIA do rótulo da “Lista de itens” da navegação do carrossel
- Definir o rótulo ARIA do item para o seu título - Se marcada, essa opção define automaticamente o título dos itens do carrossel de acordo com a sua descrição de rótulo ARIA.
Selecionar painel select-panel
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, e para reorganizar facilmente a ordem dos slides.
Depois de optar por 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 de design design-dialog
A caixa de diálogo de design permite que o autor do modelo defina quais componentes podem ser adicionados como slides ao componente Carrossel, os padrões de transição automática e quais estilos personalizados estão disponíveis para o autor de conteúdo.
Guia Propriedades properties-tab-1
A guia Propriedade é usada para definir as configurações padrão para as transições de slides quando um autor de conteúdo adiciona o componente 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 Carrossel a uma página.
- Prefixar elementos de controle - Quando marcada, os elementos de controle serão colocados na frente dos itens do carrossel para melhorar a acessibilidade.
Guia Componentes permitidos allowed-components-tab
A guia Componentes permitidos é usada para definir quais componentes podem ser adicionados como slides ao componente Carrossel pelo autor de conteúdo.
Ela funciona da mesma maneira que a guia de mesmo nome ao definir a política e as propriedades de um Contêiner de layout no Editor de modelo.
Guia Estilos styles-tab
O componente Carrossel é compatível com o Sistema de Estilos do AEM.
Camada de dados de clientes Adobe data-layer
O componente Carrossel é compatível com a Camada de dados de clientes Adobe.