Table Row

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-table-row agrupa as células de uma linha. Use-o dentro de <br-table-header> para compor uma linha de cabeçalho, ou dentro de <br-table-body> para compor uma linha de dados em <br-table>. No cabeçalho, inclua <br-table-header-cell>; no corpo, inclua <br-table-cell>:

<br-table>
  <br-table-header slot="header">
    <br-table-row>
      <br-table-header-cell>Nome</br-table-header-cell>
      <br-table-header-cell>Órgão</br-table-header-cell>
    </br-table-row>
  </br-table-header>
  <br-table-body slot="body">
    <br-table-row>
      <br-table-cell>Ana</br-table-cell>
      <br-table-cell>Ministério</br-table-cell>
    </br-table-row>
  </br-table-body>
</br-table>

Use o componente como parte dessa composição, não isoladamente.

getMeasuredHeight() retorna uma Promise<number> com a maior altura, em pixels, das células diretamente pertencentes à linha, somada à área expandida renderizada. Células de linhas aninhadas não entram no cálculo.

Visão Geral

Para a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o Design System do GovBR.

Representa uma linha de dados e sua área opcional de conteúdo expandido. É uma peça declarativa de br-table-body ou br-table-header, coordenada por br-table. Recebe células de dados ou cabeçalho conforme o pai. rowGroup identifica linhas contíguas que devem permanecer juntas; use-o apenas no corpo. Em grupos, os detalhes expandidos são apresentados após as linhas do grupo.

Propriedades

expanded

Atributo	expanded
Descrição	Indica se o conteúdo adicional da linha está visível.
Tipo	boolean
Valor padrão	false

horizontalAlignment

Atributo	horizontal-alignment
Descrição	Alinhamento horizontal herdado pelas células da linha.
Tipo	"center" | "end" | "start"
Valor padrão	---

overflow

Atributo	overflow
Descrição	Estratégia de overflow herdada pelas células da linha.
Tipo	"truncate" | "wrap"
Valor padrão	---

rowExpansion

Atributo	row-expansion
Descrição	Controla se a expansão é habilitada, desabilitada ou herdada da tabela.
Tipo	"disabled" | "enabled" | "inherit"
Valor padrão	'inherit'

rowGroup

Atributo	row-group
Descrição	Identifica um grupo contíguo de linhas com chave exclusiva, preservado como unidade na ordenação, paginação e virtualização. Vazio ou omitido mantém a linha independente. A seleção continua sendo individual por linha.
Tipo	string
Valor padrão	---

selected

Atributo	selected
Descrição	Indica se a linha está selecionada.
Tipo	boolean
Valor padrão	false

tooltipMode

Atributo	tooltip-mode
Descrição	Modo de exibição herdado pelos tooltips da linha.
Tipo	"disabled" | "enabled" | "inherit"
Valor padrão	---

tooltipState

Atributo	tooltip-state
Descrição	Estado visual herdado pelos tooltips da linha.
Tipo	"danger" | "info" | "success" | "warning"
Valor padrão	---

verticalAlignment

Atributo	vertical-alignment
Descrição	Alinhamento vertical herdado pelas células da linha.
Tipo	"center" | "end" | "start"
Valor padrão	---

virtualExpandedContentHeight

Atributo	virtual-expanded-content-height
Descrição	Altura visível da área expandida desta linha, em pixels.
Observações	Quando omitida, herda virtualExpandedContentHeight de br-table.
Tipo	number
Valor padrão	null

Métodos

getMeasuredHeight

Descrição	Retorna a maior altura das células desta linha somada à área de expansão, em pixels.
Assinatura	getMeasuredHeight() => Promise<number>
Parâmetros	---

Slots

Nome	Descrição
"default"	Células de dados da linha.
"expanded-content"	Conteúdo arbitrário exibido abaixo da linha.

Eventos

Evento	Descrição	Depreciação	Propagação
brAlignmentChange	Emitido quando uma propriedade de alinhamento da linha muda.	---	true
brOverflowChange	Emitido quando a estratégia de overflow da linha muda.	---	true

CSS Shadow Parts

Nome	Descrição
"expanded-content"	Área de conteúdo expandido.
"row"	Contêiner estrutural da linha.

Dependências

Componente pai

• br-table

Usado por

• br-table

Gráfico