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-fieldExemplos
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
Valor com link
- maria@youx.com
Valor com badge
- Status
- Ativo