MarsalaDS

Buscar

Páginas e componentes da documentação

Detail Field

Telefone
(33) 9 9999-9999

Uso

Par rótulo + valor em telas somente leitura (perfil, ficha, confirmação). Semântica dl/dt/dd; sem input e sem htmlFor. Para editar, use Field.

Quando usar

  • Perfil, detalhe de entidade e resumo antes de salvar: DetailFieldGroup → DetailField → DetailFieldLabel + DetailFieldValue.
  • Grid de ficha com columns={2} ou columns={3}; no mobile as colunas empilham.
  • Título de seção com heading ou CardTitle — o campo é só o par rótulo/valor.
  • Valor vazio: deixe children vazio; o componente mostra “-” (prop empty para outro placeholder).

Evite quando

  • Não use Field / FieldLabel aqui — isso espera um controle com htmlFor.
  • Não monte div + text-muted-foreground no lugar deste primitivo.
  • Não deixe o valor em branco: o “-” (ou empty) precisa aparecer.

Instalação

Com o namespace @youxgroup configurado em components.json (veja Instalação).

pnpm dlx shadcn@latest add @youxgroup/detail-field

Exemplos

Variações comuns de uso.

Campo simples

Telefone
(33) 9 9999-9999

Valor vazio

CEP
-

Horizontal

Status
Ativo

Grid de perfil

Nome
Maria Silva
CPF
123.456.789-00
Telefone
(33) 9 9999-9999
CEP
-

Em Card

Informações pessoais
Nome
Maria Silva
CPF
123.456.789-00
Telefone
(33) 9 9999-9999
CEP
-

Valor com link

Valor com badge

Status
Ativo
Marsala Design System