carousel-page
Visão Geral
Design System
Subcomponente do br-carousel. Representa um slide individual dentro do carrossel.
Deve ser usado exclusivamente como filho direto de br-carousel.
Para a documentação completa de design, consulte o Design System do GovBR.
Propriedades
active
| Atributo | active |
| Descrição | Marca este slide como visível e acessível. Pode ser usado declarativamente no HTML para definir o slide inicial: Em runtime, o br-carousel pai gerencia o estado via setActive(). |
| Tipo | boolean |
| Valor padrão | false |
customId
| Atributo | custom-id |
| Descrição | Identificador único customizável do slide. Quando definido, é aplicado diretamente ao atributo id do elemento host,garantindo que referências ARIA externas, testes automatizados e âncoras funcionem corretamente. O br-carousel pai detecta este valor e usa-o também no controls-id do indicador de tabs,mantendo o vínculo ARIA entre tab e tabpanel automaticamente. |
| Tipo | string |
| Valor padrão | --- |
Slots
| Nome | Descrição |
|---|---|
"default" | Qualquer conteúdo: imagens, textos, cards, vídeos, outros componentes do Design System. |
Métodos
setActive
| Assinatura | setActive(active: boolean) => Promise<void> |
| Descrição | Ativa ou desativa o slide. |
| Parâmetros | active: |
setLabel
| Assinatura | setLabel(defaultLabel: string) => Promise<void> |
| Descrição | Define o label acessível (aria-label) do slide.Chamado pelo br-carousel pai para aplicar o label gerado automaticamentecom base na posição do slide (ex: "Slide 1 de 3").O aria-label declarado diretamente no elemento tem prioridade:se o consumidor definir aria-label no HTML ou via setAttribute,esse valor será mantido e o parâmetro defaultLabel será ignorado. |
| Parâmetros | defaultLabel: - Label de fallback gerado pelo br-carousel (ex: "Slide 2 de 4"). |
CSS Shadow Parts
| Nome | Descrição |
|---|---|
"content" | Wrapper interno do conteúdo do slide. |