# Input

> Kolom teks satu baris.

Input menerima satu baris teks, misalnya nama, alamat email, atau kata pencarian.

## Kapan dipakai

- Pakai untuk teks bebas yang pendek.
- Pakai [Select](https://design.sosialoka.tech/id/components/select/) kalau jawabannya dipilih dari daftar pendek.
- Selalu pasangkan dengan [Label](https://design.sosialoka.tech/id/components/label/). Placeholder bukan label.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/input/_

### Lakukan dan jangan

- **Lakukan:** Taruh label di atas kolom, supaya tetap terlihat saat orang mengetik.
- **Jangan:** Jangan pakai placeholder sebagai label; teksnya hilang begitu orang mengetik.

## Anatomi

1. Label di atas kolom
2. Kolom dengan garis input
3. Nilai
4. Kursor

Label di atas kolom, kolomnya sendiri, lalu hint opsional di bawahnya. Kolom memakai `input` untuk garis tepi, `radius-md` untuk sudut, dan `ring` untuk fokus.

## Varian

Hanya ada satu gaya. Kolom yang tidak valid memasang `aria-invalid`, sehingga garis tepi dan cincin fokusnya berubah `destructive`.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `value` / `defaultValue` | `v-model` / `default-value` | `controller` / `initialValue` | string | tidak ada | Isi teks. |
| `type` | `type` | `keyboardType` | string | `text` | Petunjuk keyboard dan validasi. |
| `disabled` | `disabled` | `enabled: false` | boolean | `false` | Mematikan pengetikan. |
| `aria-invalid` | `aria-invalid` | `validator` | boolean | `false` | Menandai nilai yang salah. |

## Kode

**React**
```tsx
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"

export default function InputDemo() {
  return (
    <div className="grid w-full max-w-sm gap-2">
      <Label htmlFor="input-demo-email">Email</Label>
      <Input id="input-demo-email" type="email" aria-describedby="input-demo-hint" />
      <p id="input-demo-hint" className="text-sm text-muted-foreground">
        Ke sini kami kirim kabar penting untukmu.
      </p>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"
</script>

<template>
  <div class="grid w-full max-w-sm gap-2">
    <Label for="input-demo-email-vue">Email</Label>
    <Input id="input-demo-email-vue" type="email" aria-describedby="input-demo-hint-vue" />
    <p id="input-demo-hint-vue" class="text-sm text-muted-foreground">
      Ke sini kami kirim kabar penting untukmu.
    </p>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

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

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 384),
      child: ShadInputFormField(
        id: 'email',
        label: const Text('Email'),
        keyboardType: TextInputType.emailAddress,
        description: const Text('Ke sini kami kirim kabar penting untukmu.'),
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/input.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/input.json
```

## Aksesibilitas

- Hubungkan label dengan `htmlFor` (React) atau `for` (Vue) ke `id` kolom.
- Hubungkan hint dengan `aria-describedby` supaya dibacakan screen reader.
- Pesan error datang dari backend. Tampilkan di bawah kolom dan pasang `aria-invalid`.
