Lewati ke konten

Field

Unduh .md

Field menaruh label di atas kontrol form, hint satu kalimat di bawahnya, dan pesan error dari backend saat nilainya ditolak.

  • Bungkus setiap kontrol form yang diisi orang: Input, Textarea, Select, Combobox, Input OTP.
  • Pakai FieldSet dengan FieldLegend untuk mengelompokkan kontrol yang menjawab satu pertanyaan, misalnya Radio Group.
  • Pakai orientasi horizontal hanya untuk Switch atau Checkbox, dengan kontrol di depan labelnya.
  • Jangan tulis pesan error di klien. Backend memeriksa setiap field dan mengirim pesannya; klien hanya menonaktifkan tombol kirim sampai field wajib terisi.
React

Tulis sesuai sampul rilis.

Opsional, untuk tim rilis.

Vue

Tulis sesuai sampul rilis.

Opsional, untuk tim rilis.

1234
  1. 1Label
  2. 2Kontrol, garis merah saat tidak valid
  3. 3Petunjuk
  4. 4Pesan error dari backend
  1. Label (FieldLabel): di atas kontrol, warna foreground. Berubah destructive saat field tidak valid.
  2. Kontrol: input, textarea, atau kontrol lain, dengan aria-invalid selama nilainya ditolak.
  3. Hint (FieldDescription): satu kalimat praktis berwarna muted-foreground.
  4. Error (FieldError): pesan dari backend berwarna destructive, dengan role="alert".

Hubungkan kontrol ke hint dan error lewat aria-describedby, supaya pembaca layar membacakan keduanya. Field tidak menambahkan id-nya otomatis.

Orientasi Pakai untuk
vertical (bawaan) Semua kontrol teks: label di atas, hint dan error di bawah.
horizontal Switch atau Checkbox: kontrol di kiri, label dan hint di kanan.
React Vue Flutter Tipe Default Kegunaan
orientation di Field orientation di Field widget terpisah (ShadSwitch punya label sendiri) vertical / horizontal vertical Menaruh label di atas atau di samping kontrol.
data-invalid di Field data-invalid="true" di Field (data-invalid tanpa nilai dirender kosong dan tidak cocok) forceErrorText boolean / teks tidak ada Menandai field yang ditolak.
FieldLabel htmlFor FieldLabel for label teks tidak ada Nama kontrol.
FieldDescription FieldDescription description teks tidak ada Hint satu kalimat.
FieldError FieldError forceErrorText teks tidak ada Pesan error dari backend.
FieldSet, FieldLegend FieldSet, FieldLegend judul Text di atas kelompok tidak ada tidak ada Mengelompokkan kontrol yang menjawab satu pertanyaan.
import { useId } from "react"
import { Field, FieldDescription, FieldError, FieldGroup, FieldLabel } from "@/components/ui/field"
import { Input } from "@/components/ui/input"
import { Textarea } from "@/components/ui/textarea"
export default function FieldDemo() {
const id = useId()
return (
<FieldGroup className="w-full max-w-sm">
{/* The error comes from the backend; the client only shows it. */}
<Field data-invalid>
<FieldLabel htmlFor={`${id}-title`}>Judul lagu</FieldLabel>
<Input
id={`${id}-title`}
aria-invalid
aria-describedby={`${id}-title-hint ${id}-title-error`}
/>
<FieldDescription id={`${id}-title-hint`}>Tulis sesuai sampul rilis.</FieldDescription>
<FieldError id={`${id}-title-error`}>Judul lagunya belum diisi.</FieldError>
</Field>
<Field>
<FieldLabel htmlFor={`${id}-notes`}>Catatan</FieldLabel>
<Textarea id={`${id}-notes`} aria-describedby={`${id}-notes-hint`} />
<FieldDescription id={`${id}-notes-hint`}>Opsional, untuk tim rilis.</FieldDescription>
</Field>
</FieldGroup>
)
}
Terminal window
npx shadcn@latest add https://design.sosialoka.tech/r/react/field.json
  • Setiap kontrol punya label yang terlihat dan terhubung lewat htmlFor / for.
  • Kontrol yang tidak valid punya aria-invalid="true" dan aria-describedby berisi id hint dan id error.
  • Error punya role="alert", jadi langsung dibacakan saat muncul.
  • FieldSet diberi nama oleh FieldLegend-nya.