# Result

O desfecho de um fluxo: o fim do checkout, o cadastro concluído, o pagamento
confirmado, o formulário longo enviado, ou a falha em qualquer um deles. Ele
toma o lugar do que a pessoa acabou de preencher e diz três coisas, nesta
ordem: o que aconteceu, o que isso quer dizer, e para onde ir agora.

```tsx
<Result
  meta="Confirmado · há instantes"
  title="Pedido confirmado"
  description="Enviamos o comprovante para o seu e-mail. A entrega sai amanhã."
  actions={
    <>
      <Button>Acompanhar pedido</Button>
      <Button variant="ghost">Continuar comprando</Button>
    </>
  }
>
  <DescriptionList variant="boxed">
    <DescriptionItem label="Pedido">#20481</DescriptionItem>
    <DescriptionItem label="Total">R$ 189,90</DescriptionItem>
  </DescriptionList>
</Result>
```

`title` é obrigatório e diz o fato em uma frase. `description` é o detalhe, e
`children` é o miolo: o resumo em linhas, o protocolo. Os botões do próximo
passo vão em `actions`, o principal primeiro. Um desfecho sem saída deixa a
pessoa olhando para uma tela que já acabou.

`meta` é a linha de contexto acima do título, em fonte mono e tom discreto: a
situação e a hora ("Confirmado · há instantes"), o código de um erro ("Erro 500
· 14:32"). Diz o que o título não diz. O resumo vai num `DescriptionList` com
`variant="boxed"`, que põe as linhas na própria caixa; não há peça de resumo à
parte, porque rótulo e valor já são o `DescriptionList`.

## Tons

`tone` escolhe o desfecho, e o símbolo muda junto com a cor, porque cor nunca é
o único sinal: `success` (o padrão) desenha o check, `info` o i, `warning` a
exclamação e `danger` o xis.

- **`success`**: deu certo, e não há nada pendente.
- **`info`**: deu certo, mas o resultado final depende de outra pessoa ("cadastro
  em análise").
- **`warning`**: deu certo em parte. Diga o que faltou e onde está.
- **`danger`**: não deu. Diga se algo foi cobrado ou salvo, que é a primeira
  pergunta de quem lê uma falha, e ofereça o caminho de tentar de novo.

## Página inteira de erro

`layout="page"` é a tela inteira de 404, de sem permissão, de fora do ar ou de
manutenção: alinhado ao início numa coluna de leitura, com título maior e o
desenho no topo. `illustration` troca o disco do símbolo pelo desenho, e as
nove do `@rivocode/ui/illustrations` foram feitas para isso:

```tsx
import { ServerError } from '@rivocode/ui/illustrations'

<Result
  layout="page"
  titleAs="h1"
  tone="danger"
  illustration={<ServerError size="lg" />}
  meta="Erro 500 · 14:32:08"
  title="Não conseguimos abrir esta página"
  description="A falha foi no nosso servidor. Sua última alteração ficou salva às 14h31."
  actions={
    <>
      <Button>Tentar de novo</Button>
      <Button variant="secondary">Ir para o início</Button>
    </>
  }
>
  <DescriptionList variant="boxed">
    <DescriptionItem label="Código do atendimento">RC-7F3A-91C2</DescriptionItem>
  </DescriptionList>
</Result>
```

O desenho sai `aria-hidden` e o `tone` continua no `data-tone`, sem pintar
nada. Não há peça `ErrorPage` à parte: a página de erro é o `Result` com
`layout="page"`. O código técnico (o 404, o identificador da requisição) vai no
`meta` ou no resumo, para quem vai abrir chamado, e nunca no título.

Cada situação pede uma coisa, e a página diz o que aconteceu com o trabalho da
pessoa:

- **404**: a culpa é nossa ("Não encontramos"), nunca "você digitou errado".
  Ofereça a busca e os atalhos das tarefas principais.
- **500**: diga se o que ela fazia foi salvo, ofereça tentar de novo e o código
  para o suporte. Sem piada: ela pode ter perdido trabalho.
- **403**: diga com qual conta ela entrou e quem pode abrir a página.
- **Sem internet**: diga o que continua funcionando e o que sobe sozinho quando
  a conexão voltar.
- **Manutenção**: um horário concreto de volta, e o que acontece com o que tem
  prazo. No servidor, a resposta é 503 com `Retry-After`.

Os blocos em `/blocos` têm as cinco montadas.

## Movimento

Na montagem o disco cresce do centro (`animate-pop`) e, no `success`, o círculo
se traça e o check se desenha por cima (`animate-draw` e `animate-draw-late`),
em pouco mais de meio segundo. Os outros tons só crescem: falha e pendência não
se comemoram. As durações são os tokens `--rc-duration-slow` e
`--rc-duration-effects`, então com "reduzir movimento" o símbolo nasce pronto.
`animated={false}` desliga numa instância.

## Acessibilidade

O `Result` costuma aparecer porque a pessoa apertou "Concluir", e o botão que
tinha o foco sumiu junto com o formulário. Por isso **o foco vai para o título
na montagem**, e o leitor de tela lê o título e a descrição. O título sai num
`h2` com `tabIndex={-1}`: recebe foco por código e não entra na ordem do Tab.
`titleAs` troca o nível, e `h1` cabe quando o `Result` é a página inteira.

Não é `role="status"`, de propósito: uma região viva que já nasce com o texto
dentro costuma não ser lida, e o foco ficaria perdido no corpo da página.

`focusOnMount={false}` desliga, e é o certo quando há mais de um na tela ou
quando ele não é a resposta a uma ação da pessoa: uma vitrine, uma página de
documentação, o estado que já estava lá quando a tela abriu.

## Partes

`classNames` alcança cada nó pelo nome: `icon` (o disco do símbolo, ou a caixa
da `illustration`), `meta`, `title`, `description`, `content` (a caixa do
`children`) e `actions`.

## Quando não usar

- **Ação pequena** (salvar um campo, copiar uma chave, arquivar uma linha) é
  `Toast`, pelo `useToast` e o `ToastViewport`. O `Toast` passa e a pessoa
  continua onde estava; o `Result` toma a tela e encerra o fluxo.
- **Falta de dado** é `EmptyState`. O `EmptyState` olha para o que ainda não
  existe e oferece criar; o `Result` olha para o que acabou de acontecer.
- **Erro ao carregar uma lista** é `QueryBoundary`. Ele cuida do carregando, do
  erro com "Tentar de novo" e do vazio de uma consulta; o `Result` com `danger`
  é para o fluxo que a pessoa conduziu e que falhou no fim.
- **Aviso dentro da página** é `Alert`. O `Alert` mora junto do conteúdo e
  deixa trabalhar; o `Result` é o conteúdo.

## No React Native

Traduz com os mesmos tons, o mesmo `layout`, o mesmo `actions` e as mesmas seis partes de `classNames`: `icon`, `meta`, `title`, `description`, `content` e `actions`. `title`, `description` e `meta` são `string`, porque moram dentro de um `Text`, e o `meta` entra no anúncio depois do título. No `layout="page"` as ações continuam na largura toda, que é o alvo de toque do celular.

**O foco no título vira anúncio.** No web o título recebe o foco ao montar; no celular o caminho que funciona igual no iOS e no Android é falar, então `announceOnMount` (padrão `true`) lê o título e a descrição uma vez, quando o `Result` aparece. Desligue quando há mais de um na tela, como o `focusOnMount` do web. O título sai como cabeçalho, sem `titleAs`: o leitor de tela do celular não anuncia nível.

**O símbolo não se traça, cresce.** É o ícone do `lucide-react-native` de cada tom (`CircleCheck`, `Info`, `CircleAlert` e `CircleX`) sobre o disco, e a animação é a do `react-native-reanimated`, que já é peer: o disco cresce do centro em `slow`, e no `success` o check cresce por cima logo depois, com o atraso de `effects`. Com "reduzir movimento", ou `animated={false}`, nasce pronto.

## Importação

```tsx
import { Result } from '@rivocode/ui'
```

## Exemplos

### Pedido confirmado, com o resumo

```tsx
import { Button, Card, DescriptionItem, DescriptionList, Field, FieldLabel, Input, Result } from '@rivocode/ui'
import { Forbidden, NotFound, ServerError } from '@rivocode/ui/illustrations'
import { useState } from 'react'

export function OrderConfirmed() {
  return (
    <Card className="w-full max-w-lg">
      <Result
        focusOnMount={false}
        meta="Confirmado · há instantes"
        title="Pedido confirmado"
        description="Enviamos o comprovante para o seu e-mail. A entrega sai amanhã."
        actions={
          <>
            <Button>Acompanhar pedido</Button>
            <Button variant="ghost">Continuar comprando</Button>
          </>
        }
      >
        <DescriptionList variant="boxed">
          <DescriptionItem label="Pedido">
            <span className="tabular-nums">#20481</span>
          </DescriptionItem>
          <DescriptionItem label="Entrega">Rua das Flores, 120</DescriptionItem>
          <DescriptionItem label="Total">
            <span className="tabular-nums">R$ 189,90</span>
          </DescriptionItem>
        </DescriptionList>
      </Result>
    </Card>
  )
}
```

### Tons

```tsx
import { Button, Card, DescriptionItem, DescriptionList, Field, FieldLabel, Input, Result } from '@rivocode/ui'
import { Forbidden, NotFound, ServerError } from '@rivocode/ui/illustrations'
import { useState } from 'react'

export function Tones() {
  return (
    <div className="grid w-full gap-4 sm:grid-cols-2">
      <Card>
        <Result
          focusOnMount={false}
          tone="success"
          title="Consulta agendada"
          description="O lembrete chega por e-mail e por SMS um dia antes."
        />
      </Card>
      <Card>
        <Result
          focusOnMount={false}
          tone="info"
          title="Inscrição em análise"
          description="Respondemos em até dois dias úteis, por e-mail."
        />
      </Card>
      <Card>
        <Result
          focusOnMount={false}
          tone="warning"
          title="Importação parcial"
          description="38 de 40 contatos entraram. Os dois que faltam estão sem e-mail."
        />
      </Card>
      <Card>
        <Result
          focusOnMount={false}
          tone="danger"
          meta="Recusado · 14:35"
          title="Pagamento recusado"
          description="Nada foi cobrado. Confira os dados do cartão ou tente outro."
          actions={<Button variant="secondary">Tentar de novo</Button>}
        />
      </Card>
    </div>
  )
}
```

### No lugar do formulário

```tsx
import { Button, Card, DescriptionItem, DescriptionList, Field, FieldLabel, Input, Result } from '@rivocode/ui'
import { Forbidden, NotFound, ServerError } from '@rivocode/ui/illustrations'
import { useState } from 'react'

export function ReplacesTheForm() {
  const [sent, setSent] = useState(false)

  return (
    <Card className="w-full max-w-lg">
      {sent ? (
        <Result
          title="Convite enviado"
          description="A pessoa recebe o link de acesso por e-mail."
          actions={
            <Button variant="secondary" onClick={() => setSent(false)}>
              Convidar outra pessoa
            </Button>
          }
        />
      ) : (
        <form
          className="flex flex-col gap-4 p-6"
          onSubmit={(event) => {
            event.preventDefault()
            setSent(true)
          }}
        >
          <Field>
            <FieldLabel>E-mail</FieldLabel>
            <Input type="email" defaultValue="marina@exemplo.com.br" />
          </Field>
          <Button type="submit">Enviar convite</Button>
        </form>
      )}
    </Card>
  )
}
```

### Página inteira de erro

```tsx
import { Button, Card, DescriptionItem, DescriptionList, Field, FieldLabel, Input, Result } from '@rivocode/ui'
import { Forbidden, NotFound, ServerError } from '@rivocode/ui/illustrations'
import { useState } from 'react'

export function ErrorPage() {
  return (
    <Result
      focusOnMount={false}
      layout="page"
      tone="danger"
      illustration={<ServerError size="lg" />}
      meta="Erro 500 · 14:32:08"
      title="Não conseguimos abrir esta página"
      description="A falha foi no nosso servidor, e não em algo que você fez. Sua última alteração ficou salva às 14h31."
      actions={
        <>
          <Button>Tentar de novo</Button>
          <Button variant="secondary">Ir para o início</Button>
        </>
      }
    >
      <DescriptionList variant="boxed">
        <DescriptionItem label="Código do atendimento">
          <span className="font-mono">RC-7F3A-91C2</span>
        </DescriptionItem>
      </DescriptionList>
    </Result>
  )
}
```

### Página que não existe, e sem permissão

```tsx
import { Button, Card, DescriptionItem, DescriptionList, Field, FieldLabel, Input, Result } from '@rivocode/ui'
import { Forbidden, NotFound, ServerError } from '@rivocode/ui/illustrations'
import { useState } from 'react'

export function OtherPages() {
  return (
    <div className="grid w-full gap-6 lg:grid-cols-2">
      <Result
        focusOnMount={false}
        layout="page"
        tone="danger"
        illustration={<NotFound size="md" />}
        meta="Página 404 · /produto/cafe-1kg"
        title="Não encontramos esta página"
        description="O endereço pode ter mudado, ou o link veio incompleto. O seu carrinho continua do jeito que estava."
        actions={
          <>
            <Button>Buscar produto</Button>
            <Button variant="secondary">Ir para o início</Button>
          </>
        }
      />
      <Result
        focusOnMount={false}
        layout="page"
        tone="warning"
        illustration={<Forbidden size="md" />}
        meta="Acesso restrito · Relatório financeiro"
        title="Esta página existe, mas sua conta não abre ela"
        description="Você entrou como ana@exemplo.com.br, no papel Recepção. O relatório é dos papéis Gestão e Administração."
        actions={
          <>
            <Button>Pedir acesso</Button>
            <Button variant="secondary">Trocar de conta</Button>
          </>
        }
      />
    </div>
  )
}
```

## Props

| Prop | Tipo | Obrigatória | Padrão | Desde | O que faz |
| --- | --- | --- | --- | --- | --- |
| `title` | `ReactNode` | sim |  | - | O que aconteceu, em uma frase: "Pedido confirmado", "Pagamento recusado". |
| `actions` | `ReactNode` |  |  | - | Os botoes do proximo passo, embaixo de tudo: centrados no `inline`, no inicio no `page`. |
| `animated` | `boolean` |  | `true` | - | Anima o simbolo na montagem: o disco cresce do centro e, no `success`, o circulo e o check se tracam por cima, em pouco mais de meio segundo. |
| `classNames` | `Partial<Record<"actions" \| "content" \| "description" \| "icon" \| "meta" \| "title", string>>` |  |  | - | Classe por parte: `icon` (o disco do simbolo, ou a caixa da `illustration`), `meta`, `title`, `description`, `content` (a caixa do `children`) e `actions`. |
| `description` | `ReactNode` |  |  | - | O detalhe e o que fazer a seguir. |
| `focusOnMount` | `boolean` |  | `true` | - | Leva o foco ao titulo na montagem, e o leitor de tela le o titulo e a descricao. |
| `illustration` | `ReactNode` |  |  | - | Desenho no lugar do disco do simbolo, para a pagina inteira de erro ou de estado: o 404, o sem permissao, o fora do ar. |
| `layout` | `ResultLayout` |  | `"inline"` | - | `inline` toma o lugar de um formulario ou de um cartao: centrado, com o simbolo do tom. |
| `meta` | `ReactNode` |  |  | - | A linha de contexto acima do titulo, em fonte mono e tom discreto: a situacao e a hora ("Confirmado - ha instantes"), o codigo do erro ("Erro 500 - 14:32"). |
| `titleAs` | `"h1" \| "h2" \| "h3"` |  | `"h2"` | - | Em que nivel o titulo sai. |
| `tone` | `ResultTone` |  | `"success"` | - | O desfecho, e a cor e o simbolo que saem dele: `success` desenha o check, `info` o i, `warning` a exclamacao e `danger` o xis. |

Além dessas: repassa `className`, `style`, `id` e os demais atributos do elemento raiz.

## Ver também

- [Alert](/componentes/alert.md)
- [Bacalhau](/componentes/bacalhau.md)
- [Badge](/componentes/badge.md)
- [Banner](/componentes/banner.md)
- [CookieConsent](/componentes/cookie-consent.md)
- [EmptyState](/componentes/empty-state.md)
- [Convenções da biblioteca](/convencoes.md): Provider, tokens e as regras que valem para toda peça
- [Índice completo](/llms.txt)
