Pular para o conteúdo
Estrutura

Item

/componentes/item.mdmarkdown cru, para quem lê com agent em vez de olho

Linha de lista

CM

Carla Menezes

Analista de dados

Ativa
DP

Diego Paiva

Designer de produto

Em férias

Com moldura

LF

Lucas Fernandes

Última consulta em 18/08

Importar
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

PropTipo
interactive0.4.0boolean | null
render

Troca 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.md

O 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.md

A 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.md

O 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.md

A 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.

O 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.

A 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.

O 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.

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.