Stack
Coluna de campos
Linha que quebra
Título e ação nas pontas
Alunos da turma A
Como lista
- Aula 1, concluída
- Aula 2, concluída
- Aula 3, em andamento
import { Stack } from '@rivocode/ui'Quando usar
Empilha os filhos numa direção, com o vão entre eles saído da escala da casa.
<Stack gap="lg">
<Field name="razao">…</Field>
<Field name="cnpj">…</Field>
<Stack direction="row" gap="sm" justify="end">
<Button variant="secondary">Cancelar</Button>
<Button>Salvar</Button>
</Stack>
</Stack>
direction escolhe o eixo: column, o padrão, põe um embaixo do outro; row
põe lado a lado. align alinha no eixo cruzado e justify distribui no eixo
principal, com between empurrando o primeiro e o último para as pontas. wrap
deixa a linha quebrar quando os filhos não cabem, que é o caso de uma fileira
de selos ou de fichas.
O vão é uma escala, e ela acompanha a densidade
gap não aceita pixel. São cinco passos, e mais none:
| Passo | Confortável | Compacta |
|---|---|---|
xs |
4px | 4px |
sm |
8px | 6px |
md |
12px | 8px |
lg |
16px | 12px |
xl |
24px | 16px |
O padrão é md. Os passos saem dos tokens --rc-gap-*, que a densidade
reescreve junto com a altura de controle: a tela que passa para
density="compact" aperta também o vão entre os blocos, e não só os controles
dentro deles. Um gap-3 escrito à mão fica com 12px nas duas.
xs não encolhe. Abaixo de 4px, selo encostado em selo vira uma palavra só.
Outro elemento
render troca o elemento sem mudar o arranjo. Uma lista continua lista para o
leitor de tela, que anuncia quantos itens ela tem:
<Stack render={<ul />} gap="sm">
<li>Aula 1, concluída</li>
<li>Aula 2, concluída</li>
</Stack>
Quando não usar
- Quando uma
divcom classe basta. Dois elementos que se alinham uma vez, num lugar só, não pedem peça:flex items-center gap-2diz a mesma coisa. OStackse paga onde o vão precisa seguir a densidade, ou onde a mesma arrumação se repete tela a tela e cada uma escolheria um número diferente. - Grade em duas dimensões. Cartões que se arrumam em colunas e linhas são
Grid, comcolumnsouminItemWidth. UmStackcomwrapquebra a linha, mas não alinha as colunas de uma linha com as da outra. - Moldura e respiro interno. O
Stacknão desenha borda nem fundo. O bloco com moldura é oCard, e o topo da tela, com título e ações, é oPageHeader. - Duas áreas que a pessoa redimensiona. Lista e detalhe com divisória que se
arrasta são o
Splitter.
No React Native
Traduz: o @rivocode/ui-native exporta Stack - mesmas props, menos render; o vão é a escala confortável, porque no toque não há densidade compacta. A API não é a mesma do web (no nativo tudo é controlado), e a tabela de paridade diz o que muda peça a peça.
API
| Prop | Tipo | Padrão |
|---|---|---|
alignO alinhamento no eixo cruzado. | "baseline""center""end""start""stretch" | sem padrão |
directionO eixo dos filhos. | "column" | "row" | "column" |
gapO vao entre os filhos, na escala da casa: `xs` 4, `sm` 8, `md` 12, `lg` 16 e `xl` 24 pixels na densidade confortavel. | "lg""md""none""sm""xl""xs" | "md" |
justifyA distribuicao no eixo principal. | "between""center""end""start" | sem padrão |
renderTroca o elemento renderizado mantendo o arranjo: `<Stack render={<ul />}>`, `<Stack render={<nav />}>`. | ReactElement<unknown, string | JSXElementConstructor<any>> | sem padrão |
wrapDeixa os filhos quebrarem linha quando nao cabem. | boolean | false |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.