Table Bar
O br-table-bar reúne o título, a busca e as ações globais ou contextuais da
tabela. Na aplicação, utilize o componente orquestrador
<br-table>, que cria e configura essa barra internamente; não
instancie br-table-bar diretamente. Configure título, busca e ações pelas
propriedades e slots de br-table, incluindo slot="global-actions" e
slot="contextual-actions" para os respectivos
<br-table-action>.
Visão Geral
Para a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o Design System do GovBR.
Exibe o título, as ações globais e as ações contextuais da tabela.
Ações excedentes são agrupadas automaticamente em um menu.
Compõe br-table, que configura a barra automaticamente. Também pode ser usada
diretamente para compor uma barra de ações. Quando hasSearch está ativo,
solicita a busca à aplicação, sem filtrar ou destacar os dados.
Propriedades
contextualActionsLimit
| Atributo | contextual-actions-limit |
|---|---|
| Descrição | Limite usado para decidir quando agrupar ações contextuais em um menu. Quando o número de ações excede esse valor, as ações são agrupadas no dropdown (atualmente todas são movidas para o menu colapsado). |
| Tipo | number |
| Valor padrão | 4 |
density
| Atributo | density |
|---|---|
| Descrição | Densidade visual aplicada aos controles internos da barra. |
| Tipo | "large" | "medium" | "small" |
| Valor padrão | --- |
hasContextualActionsContent
| Atributo | has-contextual-actions-content |
|---|---|
| Descrição | Indica se o slot de ações contextuais possui conteúdo. |
| Tipo | boolean |
| Valor padrão | false |
hasGlobalActionsContent
| Atributo | has-global-actions-content |
|---|---|
| Descrição | Indica se o slot de ações globais possui conteúdo. |
| Tipo | boolean |
| Valor padrão | false |
hasSearch
| Atributo | has-search |
|---|---|
| Descrição | Disponibiliza a interface de busca controlada pela aplicação. |
| Tipo | boolean |
| Valor padrão | false |
heading
| Atributo | heading |
|---|---|
| Descrição | Título apresentado na barra principal. |
| Tipo | string |
| Valor padrão | '' |
headingActionsLimit
| Atributo | heading-actions-limit |
|---|---|
| Descrição | Limite usado para decidir quando agrupar ações em um menu. Quando o número de ações excede esse valor, as ações são agrupadas no dropdown (atualmente todas são movidas para o menu colapsado). |
| Tipo | number |
| Valor padrão | 4 |
selectedRowsCount
| Atributo | selected-rows-count |
|---|---|
| Descrição | Número de linhas atualmente selecionadas. |
| Tipo | number |
| Valor padrão | 0 |
showContextualBar
| Atributo | show-contextual-bar |
|---|---|
| Descrição | Força a apresentação da barra contextual mesmo sem seleção. |
| Tipo | boolean |
| Valor padrão | false |
Slots
| Nome | Descrição |
|---|---|
"contextual-actions" | Ações aplicadas às linhas selecionadas. |
"global-actions" | Ações relacionadas ao conjunto completo de dados. |
Eventos
| Evento | Descrição | Depreciação | Propagação |
|---|---|---|---|
brTableSearch | Evento customizado emitido pela barra ao enviar a busca por Enter ou pelo botão, com { term }, e ao fechar, com { term: '' }. Propaga até br-table e atravessa Shadow DOM; é cancelável. Digitação, inicialização e alterações programáticas não emitem o evento. | --- | true |
