Lewati ke konten

Form

Unduh .md

Tampilan dan perilaku form sama di semua produk dan framework. Ini termasuk Flutter, yang dulu memakai floating label di dalam isian.

  • Pakai untuk membuat atau mengubah data.
  • Form yang panjang dipecah menjadi beberapa kartu, masing-masing dengan satu judul. Untuk masuk, pakai pola Login.
  1. Kartu berisi judul dan satu kalimat tentang apa yang perlu diisi.
  2. Isian, masing-masing dengan label di atasnya dan hint satu kalimat di bawahnya (opsional).
  3. Error di bawah isiannya, berwarna destructive, dan terhubung ke isian lewat aria-describedby.
  4. Footer: “Batal” sebagai tombol outline, lalu aksi utama.
  • Label di atas isian, jangan di dalamnya sebagai placeholder atau floating label.
  • Hint cukup satu kalimat praktis: apa yang diisi, contoh, atau batasan.
  • Error datang dari backend. Klien hanya mengaktifkan atau menonaktifkan tombol kirim, dan tidak pernah menulis pesan error sendiri. Isian yang error diberi aria-invalid="true".
  • Satu aksi utama per form, paling akhir di footer.
import { Button } from "@/components/ui/button"
import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "@/components/ui/card"
import { Checkbox } from "@/components/ui/checkbox"
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"
import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"
const genres = [
{ label: "Pilih genre", value: null },
{ label: "Pop", value: "pop" },
{ label: "Rock", value: "rock" },
{ label: "Dangdut", value: "dangdut" },
{ label: "Jazz", value: "jazz" },
]
/**
* A form: labels above the fields, a one-sentence hint under a field, the error the backend sent under its
* field, and the actions in the card footer. The error text comes from the API response, never from the client.
*/
export default function FormPageDemo() {
return (
<div className="min-h-svh bg-background p-6 text-foreground">
<form className="mx-auto max-w-2xl" onSubmit={(e) => e.preventDefault()}>
<Card>
<CardHeader>
<CardTitle>Data rilis</CardTitle>
<CardDescription>Isi sesuai yang akan tampil di platform musik.</CardDescription>
</CardHeader>
<CardContent className="grid gap-5">
<div className="grid gap-2">
<Label htmlFor="release-title">Judul</Label>
<Input
id="release-title"
aria-invalid="true"
aria-describedby="release-title-hint release-title-error"
/>
<p id="release-title-hint" className="text-sm text-muted-foreground">
Tulis persis seperti di sampul.
</p>
<p id="release-title-error" className="text-sm text-destructive">
Judul lagunya belum diisi.
</p>
</div>
<div className="grid gap-2">
<Label htmlFor="release-artist">Artis</Label>
<Input id="release-artist" defaultValue="Raka Pratama" />
</div>
<div className="grid gap-2">
<Label htmlFor="release-genre">Genre</Label>
<Select items={genres}>
<SelectTrigger id="release-genre" className="w-full">
<SelectValue />
</SelectTrigger>
<SelectContent>
{genres
.filter((g) => g.value !== null)
.map((g) => (
<SelectItem key={g.value} value={g.value}>
{g.label}
</SelectItem>
))}
</SelectContent>
</Select>
</div>
<div className="flex items-center gap-2">
<Checkbox id="release-explicit" />
<Label htmlFor="release-explicit">Lagu ini mengandung lirik eksplisit</Label>
</div>
</CardContent>
<CardFooter className="justify-end gap-2">
<Button type="button" variant="outline">
Batal
</Button>
<Button type="submit">Simpan</Button>
</CardFooter>
</Card>
</form>
</div>
)
}

Card, Label, Input, Select, Checkbox, dan Button.

Pakai ShadInputFormField(label: …), bukan InputDecoration.labelText, supaya label ada di atas isian seperti di web. Tampilkan pesan dari backend lewat forceErrorText.