Notification Item

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-notification-item representa uma notificação individual no painel. Deve ser inserido dentro do <br-notification-body> no contexto do orquestrador <br-notification>.

Visão Geral

Subcomponente individual de br-notification, utilizado para representar visualmente cada mensagem, aviso ou comunicado do sistema.

Papel na composição

• Exibe o ícone de status (sucesso, aviso, erro, informação), título do comunicado, data/hora e texto explicativo.
• Suporta indicação visual de lida/não lida e botões de ação específicos (ex.: "Ver detalhes", "Arquivar").

Regra de uso e relacionamento

Deve ser declarado dentro do contêiner br-notification-body (ou no slot padrão do br-notification). Comunica interações da pessoa usuária (clique no item, dispensa) através de eventos emitidos para a aplicação.

Para a documentação completa de design, consulte o Design System do GovBR.

Propriedades

clickable

Atributo	clickable
Descrição	Define se o item é interativo.
Tipo	boolean
Valor padrão	true

datetime

Atributo	datetime
Descrição	Informação cronológica associada à notificação.
Tipo	string
Valor padrão	---

description

Atributo	description
Descrição	Conteúdo resumido ou complementar da notificação.
Tipo	string
Valor padrão	---

itemId

Atributo	item-id
Descrição	Identificador único do item. Quando omitido, um valor é gerado automaticamente. > Padrão: valor único gerado por generateUniqueId().
Tipo	string
Valor padrão	generateUniqueId()

label

Atributo	label
Descrição	Título principal da notificação. (obrigatório)
Tipo	string
Valor padrão	---

state

Atributo	state
Descrição	Define o estado visual da notificação. Aceita success, danger, warning ou info. Valores inválidos são ignorados.
Tipo	"danger" | "info" | "success" | "warning"
Valor padrão	---

unread

Atributo	unread
Descrição	Indica se a notificação ainda não foi lida.
Tipo	boolean
Valor padrão	false

Slots

Nome	Descrição
"actions"	Ações contextuais do item.
"default"	Conteúdo principal da notificação.
"meta"	Região para informação cronológica ou metadados.
"status"	Região para tag, badge ou marcador visual de status.
"title"	Conteúdo customizado do título.

Eventos

Evento	Descrição	Depreciação	Propagação
brNotificationItemRead	Informa mudança de estado para lido.	---	true
brNotificationItemSelect	Informa seleção ou acionamento do item.	---	true

Métodos

callFocus

Descrição	Move o foco para o elemento interativo do item.
Assinatura	callFocus() => Promise<void>
Parâmetros	---

Dependências

Componente pai

• br-notification

Depende de

• br-item
• br-tag

Gráfico