Início rápido
Uma tela de verdade: formulário que valida e listagem com os estados.
Uma tela de verdade, do zero, com os pedaços que quase toda tela de aplicação tem: um formulário que valida, uma listagem que sabe carregar e falhar, e um aviso no fim.
Se ainda não instalou, comece pela Instalação.
O esqueleto
import { RivoProvider } from '@rivocode/ui'
import './styles.css'
export function App() {
return (
<RivoProvider theme="rivocode-dark">
<OrderScreen />
</RivoProvider>
)
}
Um formulário que valida
O subcaminho @rivocode/ui/form junta React Hook Form e Zod. O schema é a
fonte da verdade: ele valida e ainda dá o tipo do formulário.
import { Button, Input } from '@rivocode/ui'
import { Form, FormField, useZodForm } from '@rivocode/ui/form'
import { z } from 'zod'
const schema = z.object({
email: z.string().email('Informe um e-mail válido'),
amount: z.string().min(1, 'Informe o valor'),
})
function OrderForm({ onPlace }: { onPlace: (data: unknown) => void }) {
const form = useZodForm(schema)
return (
<Form form={form} onSubmit={onPlace}>
<FormField name="email" label="E-mail do cliente" description="Para onde vai a confirmação do pedido">
{(field) => <Input {...field} type="email" placeholder="nome@empresa.com.br" />}
</FormField>
<FormField name="amount" label="Valor">
{(field) => <Input {...field} placeholder="0,00" />}
</FormField>
<Button type="submit" loading={form.formState.isSubmitting}>
Registrar pedido
</Button>
</Form>
)
}
O FormField não inventa id. Ele monta rótulo, controle, ajuda e erro dentro
do Field, e a Base UI liga aria-describedby e aria-invalid sozinha para
qualquer controle dela que esteja lá dentro.
Uma listagem que conhece os quatro finais
Toda consulta tem quatro finais: carregando, deu certo, deu errado, e veio
vazia. O DataTable recebe os quatro e desenha cada um, sem a biblioteca saber
o que é React Query.
import { Badge, DataTable } from '@rivocode/ui'
function OrderList({ query }) {
return (
<DataTable
data={query.data}
isLoading={query.isLoading}
isError={query.isError}
onRetry={query.refetch}
rowKey={(order) => order.id}
empty={{
title: 'Nenhum pedido por aqui',
description: 'Quando a loja vender pela primeira vez, o pedido aparece nesta lista.',
}}
columns={[
{ key: 'number', header: 'Número' },
{ key: 'customer', header: 'Cliente' },
{ key: 'amount', header: 'Valor', align: 'right' },
{
key: 'status',
header: 'Situação',
align: 'right',
cell: (order) => <Badge tone={order.paid ? 'success' : 'neutral'}>{order.status}</Badge>,
},
]}
/>
)
}
Funciona igual com fetch na mão, com SWR ou com server component: o que a
tabela quer são os três sinais, não a biblioteca que os produziu.
hideOnMobile numa coluna some com ela na tela estreita, use para o que dá
para descobrir de outro jeito.
Avisar sem montar portal
import { Button, useToast } from '@rivocode/ui'
function ShipButton() {
const toast = useToast()
return (
<Button
onClick={async () => {
await ship()
toast.add({
title: 'Pedido 4816 despachado',
description: 'O código de rastreio foi enviado para o e-mail do cliente.',
})
}}
>
Despachar
</Button>
)
}
O viewport de avisos já está montado pelo Provider. Você chama add e o aviso
aparece no canto.
O que ler depois
- Temas e personalização: vestir a biblioteca com a cor do cliente
- Para agents: a documentação em markdown cru