# Label

> Memberi nama kontrol form dan memfokuskannya saat diklik.

Label memberi nama kontrol form, dan mengekliknya memindahkan fokus ke kontrol itu.

## Kapan dipakai

- Beri label yang terlihat di setiap input, select, dan checkbox.
- Taruh label di atas input dan select, dan di samping checkbox.
- Buat label singkat. Taruh panduan di hint di bawah kolom.

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

## Anatomi

1. Teks label
2. Tanda wajib
3. Kontrol yang dinamainya

Satu baris teks `text-sm` medium berwarna `foreground`. Kontrol yang dimatikan ikut meredupkan labelnya.

## Varian

Hanya ada satu gaya.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `htmlFor` | `for` | `label` di form field | string | tidak ada | `id` kontrol yang diberi nama. |

## Kode

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

export default function LabelDemo() {
  return (
    <div className="grid w-full max-w-sm gap-2">
      <Label htmlFor="label-demo-name">Nama lengkap</Label>
      <Input id="label-demo-name" />
    </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="label-demo-name-vue">Nama lengkap</Label>
    <Input id="label-demo-name-vue" />
  </div>
</template>
```

**Flutter**
```dart
// Flutter has no separate label widget: form fields take a `label`.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

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

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 384),
      child: ShadInputFormField(
        id: 'name',
        label: const Text('Nama lengkap'),
      ),
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Dirender sebagai `label` asli, jadi mengekliknya memfokuskan kontrol.
- Flutter tidak punya widget label terpisah. Isi `label` di form field.
