# Form

> Form dengan label di atas isian, hint satu kalimat, error dari backend, dan aksi di footer.

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

## Kapan dipakai

- Pakai untuk membuat atau mengubah data.
- Form yang panjang dipecah menjadi beberapa kartu, masing-masing dengan satu judul. Untuk masuk, pakai pola [Login](https://design.sosialoka.tech/id/patterns/login/).

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/form/_

## Anatomi

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.

## Aturan

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

## Kode

**React**
```tsx
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>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
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"

/**
 * 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.
 */
const genres = [
  { label: "Pop", value: "pop" },
  { label: "Rock", value: "rock" },
  { label: "Dangdut", value: "dangdut" },
  { label: "Jazz", value: "jazz" },
]
</script>

<template>
  <div class="min-h-svh bg-background p-6 text-foreground">
    <form class="mx-auto max-w-2xl" @submit.prevent>
      <Card>
        <CardHeader>
          <CardTitle>Data rilis</CardTitle>
          <CardDescription>Isi sesuai yang akan tampil di platform musik.</CardDescription>
        </CardHeader>
        <CardContent class="grid gap-5">
          <div class="grid gap-2">
            <Label for="release-title-vue">Judul</Label>
            <Input id="release-title-vue" aria-invalid="true" aria-describedby="release-title-hint-vue release-title-error-vue" />
            <p id="release-title-hint-vue" class="text-sm text-muted-foreground">Tulis persis seperti di sampul.</p>
            <p id="release-title-error-vue" class="text-sm text-destructive">Judul lagunya belum diisi.</p>
          </div>
          <div class="grid gap-2">
            <Label for="release-artist-vue">Artis</Label>
            <Input id="release-artist-vue" default-value="Raka Pratama" />
          </div>
          <div class="grid gap-2">
            <Label for="release-genre-vue">Genre</Label>
            <Select>
              <SelectTrigger id="release-genre-vue" class="w-full">
                <SelectValue placeholder="Pilih genre" />
              </SelectTrigger>
              <SelectContent>
                <SelectItem v-for="g in genres" :key="g.value" :value="g.value">{{ g.label }}</SelectItem>
              </SelectContent>
            </Select>
          </div>
          <div class="flex items-center gap-2">
            <Checkbox id="release-explicit-vue" />
            <Label for="release-explicit-vue">Lagu ini mengandung lirik eksplisit</Label>
          </div>
        </CardContent>
        <CardFooter class="justify-end gap-2">
          <Button type="button" variant="outline">Batal</Button>
          <Button type="submit">Simpan</Button>
        </CardFooter>
      </Card>
    </form>
  </div>
</template>
```

**Flutter**
```dart
// A form: labels above the fields (ShadInputFormField's label, never a floating Material labelText),
// a one-sentence hint, the error the backend sent under its field, and the actions at the bottom.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class FormPageDemo extends StatelessWidget {
  const FormPageDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return ShadCard(
      width: 576,
      title: Text('Data rilis', style: theme.textTheme.h4),
      description: const Text('Isi sesuai yang akan tampil di platform musik.'),
      footer: Row(
        mainAxisAlignment: MainAxisAlignment.end,
        children: [
          ShadButton.outline(onPressed: () {}, child: const Text('Batal')),
          const SizedBox(width: 8),
          ShadButton(onPressed: () {}, child: const Text('Simpan')),
        ],
      ),
      child: Padding(
        padding: const EdgeInsets.symmetric(vertical: 16),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            ShadInputFormField(
              id: 'title',
              label: const Text('Judul'),
              description: const Text('Tulis persis seperti di sampul.'),
              // The message comes from the API response; the app never writes its own.
              forceErrorText: 'Judul lagunya belum diisi.',
            ),
            const SizedBox(height: 16),
            ShadInputFormField(id: 'artist', label: const Text('Artis'), initialValue: 'Raka Pratama'),
            const SizedBox(height: 16),
            ShadSelectFormField<String>(
              id: 'genre',
              label: const Text('Genre'),
              minWidth: 544,
              placeholder: const Text('Pilih genre'),
              options: const [
                ShadOption(value: 'pop', child: Text('Pop')),
                ShadOption(value: 'rock', child: Text('Rock')),
                ShadOption(value: 'dangdut', child: Text('Dangdut')),
                ShadOption(value: 'jazz', child: Text('Jazz')),
              ],
              selectedOptionBuilder: (context, value) => Text(value),
            ),
            const SizedBox(height: 16),
            ShadCheckboxFormField(
              id: 'explicit',
              initialValue: false,
              inputLabel: const Text('Lagu ini mengandung lirik eksplisit'),
            ),
          ],
        ),
      ),
    );
  }
}
```

## Dibangun dari

[Card](https://design.sosialoka.tech/id/components/card/), [Label](https://design.sosialoka.tech/id/components/label/), [Input](https://design.sosialoka.tech/id/components/input/), [Select](https://design.sosialoka.tech/id/components/select/), [Checkbox](https://design.sosialoka.tech/id/components/checkbox/), dan [Button](https://design.sosialoka.tech/id/components/button/).

## Flutter

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