ErrorState

ErrorState é o bloco que aparece quando uma parte da tela falhou ao carregar. Ele tem a mesma forma do EmptyState, com um título, um texto opcional e um botão opcional, mas é anunciado como alerta para leitores de tela.

Quando usar

Use quando uma área não pôde ser carregada e a pessoa precisa saber disso. O título diz o que falhou; o botão, se houver, leva a uma saída, como voltar ou tentar de novo. Para uma lista que simplesmente não tem registros, use EmptyState.

Regras de exibição:

• O bloco tem role="alert", então é anunciado assim que aparece (ui/panel/states.ts:23).
• O id padrão do título é error-state-title. Como no EmptyState, duas áreas na mesma tela pedem ids diferentes (ui/panel/states.ts:22).

Onde aparece no painel

A Visão geral troca um widget que falhou por este bloco, com o título «Não foi possível carregar» seguido do nome do widget (panel/screens/overview.ts:44). A falha é registrada na auditoria antes disso (panel/screens/overview.ts:43), com a ação widget.error.

Variantes e propriedades

ErrorState

Pasta: ui/panel

Variantes

Id	Variante	Tom
states-error-light	list	light

Propriedades

Propriedade	Tipo	Obrigatória	Descrição
title	string	Sim	—
text	string	Não	—
action	StateAction	Não	—
id	string	Não	Heading id (default `<kind>-state-title`); two states on one screen MUST pass distinct ids.

Captura

A primeira variante do catálogo, a lista que não carregou, em 1280 px:

A mesma variante em 360 px:

Origem

• ui/panel/states.ts: ErrorState e o StateProps que ele compartilha com EmptyState.
• ui/panel/states.gallery.ts: as variantes do catálogo.