ItemGroup
Tela de ajustes
Valor sem navegar
- , 4.2.0
Versão
Atualizada em 12/11
- , Equipe, 8 lugares
Plano
import { ItemGroup } from '@rivocode/ui'Quando usar
A lista agrupada das telas de ajustes: um título em cima, as linhas numa caixa só, separadas por traço fino, e uma nota embaixo.
É o desenho que toda tela de configurações repete, do celular ao painel do
navegador. Sem ele, cada projeto monta a caixa com Card, enfileira Item
com borda à mão e escreve o título num texto solto, e cada um acerta o canto e o
respiro de um jeito.
<ItemGroup title="Preferências" footer="Vale para todos os aparelhos em que você entrou.">
<Item interactive render={<a href="/ajustes/idioma" />}>
<ItemContent>
<ItemTitle>Idioma</ItemTitle>
</ItemContent>
<ItemValue>Português</ItemValue>
<ItemChevron />
</Item>
<Switch checked={lembrete} onCheckedChange={setLembrete}>
Lembrete de vencimento
</Switch>
</ItemGroup>
Cada filho é uma linha. O grupo põe cada um num <li>, desenha o traço
entre eles e dá o canto da caixa só à primeira e à última. Dentro dele o Item
perde a moldura própria e ganha a altura de linha, que acompanha a densidade, e
o Switch com texto vira linha inteira, com o rótulo à esquerda e a chave à
direita: clicar em qualquer ponto da linha liga e desliga.
A linha que abre outra tela é um Item com interactive e render de
link ou botão, com ItemValue para o que está escolhido e ItemChevron para
a seta. O valor entra no nome falado depois do título, com uma pausa: o leitor
de tela diz "Idioma, Português", e a seta fica muda.
O título é o nome da lista, e a nota é a descrição dela: quem navega pelo
leitor de tela ouve "Preferências, lista, 2 itens". O título é texto apagado por
padrão, como nas telas de ajustes do sistema. Se a seção precisa aparecer no
roteiro de títulos da página, passe um Heading no title, com o nível que a
página pede: o grupo não adivinha nível.
Partes
classNames alcança cada nó pelo nome: title, list (a caixa com borda, que
é o <ul>) e footer. O className veste a raiz, que segura as três.
Quando não usar
- Ficha de rótulo e valor que só se lê é
DescriptionList, que sai como<dl>. OItemGroupé para linhas que se tocam ou que ligam alguma coisa; o número do pedido, o CNPJ e a data de emissão não abrem tela nenhuma. - Conteúdo com cabeçalho, corpo e ação é
Card. O cartão agrupa assunto, e oItemGroupagrupa linhas iguais. Um cartão com uma lista de ajustes dentro é a forma que esta peça veio substituir. - Lista que vem de uma consulta, com carregando, vazio e erro, é
DataListno React Native eDataTableouItememdivide-yno navegador. A tela de ajustes é escrita à mão e tem tamanho conhecido; registros do servidor não. - Formulário que se envia de uma vez é
FieldsetcomField. Ajuste que vale na hora fica aqui; o que precisa de "Salvar" vai para o formulário, com aSaveBar.
No React Native
Traduz, e é a peça que a tela de ajustes de um app em Expo pedia: o título vira cabeçalho e nome da lista, a caixa recorta o canto da primeira e da última linha, e o traço fino separa as do meio. As linhas são os mesmos filhos do web, com a API do nativo: Item com title, value, chevron e onPress, e Switch com texto.
<ItemGroup title="Preferências" footer="Vale para todos os aparelhos.">
<Item title="Idioma" value="Português" chevron onPress={abrirIdioma} />
<Switch checked={lembrete} onCheckedChange={setLembrete}>
Lembrete de vencimento
</Switch>
</ItemGroup>
A linha que navega fala o valor: o leitor de tela ouve “Idioma, Português, botão”, e a seta é o ChevronRight do lucide-react-native, o mesmo do web. O Switch com texto é uma parada só: o rótulo à esquerda, a chave à direita, e tocar em qualquer ponto da linha troca. title e footer são texto, e não nó, porque o título também é o accessibilityLabel da lista.
API
| Prop | Tipo |
|---|---|
classNamesClasse por parte: `title`, `list` (a caixa com borda, que e o `<ul>`) e `footer`. | Partial<Record<"footer" | "list" | "title", string>> |
footerA nota embaixo da caixa, menor e apagada: o que acontece quando se liga, de onde vem o valor. | ReactNode |
titleO nome da secao, acima da caixa: "Conta", "Notificacoes". | ReactNode |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.