Item
Linha de lista
Carla Menezes
Analista de dados
Diego Paiva
Designer de produto
Com moldura
Lucas Fernandes
Última consulta em 18/08
import { Item } from '@rivocode/ui'Quando usar
A linha de lista: alguma coisa à esquerda, texto no meio, ação à direita.
Existe porque metade de qualquer tela é isso, e sem uma peça com nome cada projeto reinventa com div solta e respiro próprio. Não é componente de dado, é de arranjo.
Compõe com ItemMedia à esquerda, ItemContent no meio (com ItemTitle e
ItemDescription dentro) e ItemActions à direita. As três colunas existem
para uma só encolher: o miolo corta o texto com reticências, e a mídia e as
ações ficam do tamanho que têm.
A linha de ajustes, "Idioma Português ›", leva ItemValue com o valor
escolhido e ItemChevron com a seta de quem abre outra tela, depois do
ItemContent. Várias dessas linhas numa caixa com título é ItemGroup.
Com interactive ganha foco e passagem; use junto com render de link ou botão,
porque cor de passagem em div não vira alvo de teclado.
Quando não usar
Quando as linhas se comparam coluna a coluna, como valor, data e situação de
vários pedidos, use DataTable: o Item arranja uma linha, e não alinha colunas
de uma linha com a outra.
Folha de rótulo e valor é DescriptionList, que sai como <dl>, e a tela de
ajustes, com seções de linhas numa caixa, é ItemGroup. E lista com
milhares de linhas é VirtualList, que pode desenhar cada uma com um Item
dentro.
No React Native
Traduz, e não concorre com o DataList: ele resolve os quatro finais de uma consulta e devolve cada linha ao renderItem sem opinião sobre o que há dentro dela. O Item é esse dentro, e serve igualmente à lista de duas escolhas numa folha, que consulta nenhuma tem. A composição do web (ItemMedia, ItemContent, ItemTitle, ItemDescription, ItemValue, ItemChevron, ItemActions) vira seis props, pela mesma regra do PageHeader: os lugares são sempre os mesmos, e prop nenhuma deixa trocar a ordem das colunas sem querer. value entra no nome falado depois do título, e chevron desenha a seta com borda, sem símbolo de texto. Com onPress a linha inteira vira alvo, com 44px de altura mínima, mas quando há actions, o alvo passa a ser só a área de texto, senão o Pressable acessível por cima engoliria o botão da direita como parada do leitor de tela. Dentro de um DataList com onRowPress, não passe onPress: um Pressable dentro do outro segura o toque no de dentro, e a linha responderia aqui e nunca lá.
API
| Prop | Tipo |
|---|---|
interactive0.4.0 | boolean | null |
renderTroca o elemento renderizado mantendo a aparencia: `<Item render={<a href="..." />}>`. | ReactElement<unknown, string | JSXElementConstructor<any>> |
variant0.4.0 | "outline""plain"null |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.
Partes
Item se monta com estas peças. Todas vivem nesta página, porque separar cada uma num endereço obrigaria a abrir seis abas para montar uma tela.
ItemActions
/item-actions.mdO canto de ação, à direita e sem encolher.
Botão de ícone, Badge de estado ou o gatilho de um Menu. Duas ações já é
muito para uma linha de lista: a terceira em diante vive dentro do menu, senão
cada linha vira uma barra de ferramentas.
Sem prop própria: repassa ao elemento de baixo o que você mandar.
ItemChevron
/item-chevron.mdA seta de quem abre outra tela, no fim da linha.
É só o desenho, e fica muda para o leitor de tela: quem navega é o render
de link ou botão do Item, e o nome falado é o da linha. Vira de lado em
página da direita para a esquerda. Linha que liga e desliga no lugar não leva
seta, porque nada se abre.
Sem prop própria: repassa ao elemento de baixo o que você mandar.
ItemContent
/item-content.mdO miolo de texto, entre a mídia e as ações.
É a única parte que encolhe, e é assim que o título corta com reticências em vez de empurrar os botões para fora da linha. Uma linha de lista que quebra o arranjo em telas estreitas quase sempre é texto solto aqui, sem esta peça em volta.
Sem prop própria: repassa ao elemento de baixo o que você mandar.
ItemDescription
/item-description.mdA segunda linha, menor e mais apagada, também cortada quando não cabe.
Uma linha, e não um parágrafo: item de lista que cresce em altura desalinha a lista inteira, e o lugar do texto longo é a tela que o item abre.
Sem prop própria: repassa ao elemento de baixo o que você mandar.
ItemMedia
/item-media.mdO canto de imagem, ícone ou avatar.
Não encolhe. É o que garante que o avatar continue redondo quando o título do lado é longo: sem isso o flex espreme a imagem antes do texto, e a lista fica com um círculo achatado por linha.
Sem prop própria: repassa ao elemento de baixo o que você mandar.
ItemTitle
/item-title.mdA primeira linha do miolo, cortada com reticências quando não cabe.
Sem prop própria: repassa ao elemento de baixo o que você mandar.
ItemValue
/item-value.mdO valor escolhido, à direita da linha e apagado: o "Português" da linha "Idioma".
Vai depois do ItemContent e antes do ItemChevron, e corta com reticências
antes de tomar mais da metade da linha. Entra no nome falado depois do título,
com uma vírgula que só o leitor de tela ouve, para "Idioma, Português" não sair
emendado. Ação ao lado do valor não cabe aqui: botão e Badge vão no
ItemActions.
Sem prop própria: repassa ao elemento de baixo o que você mandar.