Menu List

Componente estável e recomendada para novos projetos.

Anatomia, uso, comportamento visual e recomendações conceituais são mantidos pelo Padrão Digital de Governo. Esta página documenta a implementação Web Components e sua API executável.

Subcomponente de Composição

O br-menu-list fornece a estrutura semântica de lista de navegação para acomodar itens interativos. Deve ser inserido no interior de <br-menu> ou de um <br-menu-group>.

Visão Geral

O componente br-menu-list é o subcomponente do GovBR-DS que fornece a estrutura semântica de lista de navegação para acomodar os itens interativos do menu.

Para que serve

• Semântica de lista: Garante marcação acessível (<ul>) para tecnologias assistivas.
• Alinhamento e ordenação: Organiza os itens verticalmente com espaçamentos padronizados.

Papel na composição

Atua como contêiner semântico de itens dentro de br-menu ou br-menu-group.

Regra de uso e relacionamento

• Deve ser inserido no interior de br-menu ou br-menu-group.
• Acomoda múltiplos subcomponentes br-menu-item.

Propriedades

divider

Atributo	divider
Descrição	Define se o item deve exibir um divisor visual. Quando ativado, adiciona uma linha separadora para organizar visualmente os itens do menu.
Tipo	boolean
Valor padrão	false

expanded

Atributo	expanded
Descrição	Define se o menu-list inicia expandido. Útil para manter agrupamentos abertos por padrão no menu contextual.
Tipo	boolean
Valor padrão	false

icon

Atributo	icon
Descrição	Identificador legado do ícone exibido no item principal do menu. Nomes simples conhecidos são resolvidos pelo registro SVG local; para classes CSS, SVGs ou bibliotecas externas, prefira o slot icon.
Tipo	string
Valor padrão	---

label

Atributo	label
Descrição	Texto do label do item do menu. Utilize esta propriedade para definir o texto que será exibido no item do menu.
Tipo	string
Valor padrão	---

menuLevel

Atributo	menu-level
Descrição	Nível do menu na hierarquia de navegação. Utilizado para determinar o comportamento do menu (acordeão para nível 0, drill-down para níveis superiores).
Tipo	number
Valor padrão	0

Slots

Nome	Descrição
"default"	Itens filhos renderizados no conteúdo do grupo.
"icon"	Ícone personalizado do item principal. Quando preenchido, substitui icon.

Eventos

Evento	Descrição	Depreciação	Propagação
folderToggled	Emitido quando um folder é expandido ou recolhido no nível 0 (comportamento acordeão).	---	true
navigateToSubmenu	Emitido quando navegando para um submenu nos níveis 1+ (comportamento drill-down).	---	true

CSS Shadow Parts

Nome	Descrição
"container"	Wrapper do grupo de menu.
"header-content"	Conteúdo textual do item de menu principal (header).
"header-icon"	Ícone do item de menu principal (header).
"header-link"	Elemento âncora do item de menu principal (header).
"header-support"	Ícone de suporte (seta) do item de menu principal (header).
"list"	Lista de itens do grupo.

Dependências

Componente pai

• br-menu

Depende de

• br-menu-item

Gráfico