# Input Group

> Input dengan tombol, ikon, atau teks yang menempel.

Input Group menempelkan ikon, teks, atau tombol kecil ke sebuah input, di dalam satu border.

## Kapan dipakai

- **Pencarian:** ikon cari di depan input.
- **Kata sandi:** tombol di belakang input untuk menampilkan atau menyembunyikan kata sandi. Inilah kolom kata sandi Sosialoka; tidak ada komponen kata sandi tersendiri.
- **Satuan dan awalan:** teks seperti `Rp` atau `.id` sebelum atau sesudah nilai.
- Jangan taruh aksi utama form di dalam grup; tempatnya di footer form.

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

## Anatomi

1. Ikon di depan
2. Input
3. Tombol yang menempel

1. **Grup** (`InputGroup`): satu border `input` dengan `radius-md`, tinggi `h-9`. Fokus pada input memberi ring ke seluruh grup.
2. **Addon** (`InputGroupAddon`): ikon, teks, atau tombol, di `inline-start` (depan) atau `inline-end` (belakang).
3. **Kontrol** (`InputGroupInput` atau `InputGroupTextarea`): kolomnya sendiri, tanpa border sendiri.

## Varian

| Posisi addon | Pakai untuk |
| --- | --- |
| `inline-start` | Ikon cari, mata uang seperti `Rp`. |
| `inline-end` | Tombol tampilkan kata sandi, satuan, tombol hapus. |
| `block-start` / `block-end` | Label atau aksi di atas atau di bawah `InputGroupTextarea`. |

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `InputGroupAddon align` | `InputGroupAddon align` | `leading` / `trailing` di `ShadInput` | `inline-start`, `inline-end`, `block-start`, `block-end` | `inline-start` | Posisi addon. |
| `InputGroupButton size` | `InputGroupButton size` | `ShadIconButton` di `trailing` | `xs`, `sm`, `icon-xs`, `icon-sm` | `xs` | Tombol kecil di dalam grup. |
| `type` di `InputGroupInput` | `type` di `InputGroupInput` | `obscureText` | teks | `text` | `password` menyembunyikan teks; `search` membuat kolom cari. |

## Kode

**React**
```tsx
import { useId, useState } from "react"
import { EyeIcon, EyeOffIcon, SearchIcon } from "lucide-react"
import { Field, FieldLabel } from "@/components/ui/field"
import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput } from "@/components/ui/input-group"

export default function InputGroupDemo() {
  const id = useId()
  const [visible, setVisible] = useState(false)
  return (
    <div className="grid w-full max-w-sm gap-6">
      <InputGroup>
        <InputGroupAddon>
          <SearchIcon />
        </InputGroupAddon>
        <InputGroupInput type="search" placeholder="Cari rilis" aria-label="Cari rilis" />
      </InputGroup>
      <Field>
        <FieldLabel htmlFor={`${id}-password`}>Kata sandi</FieldLabel>
        <InputGroup>
          <InputGroupInput id={`${id}-password`} type={visible ? "text" : "password"} autoComplete="current-password" />
          <InputGroupAddon align="inline-end">
            <InputGroupButton
              size="icon-xs"
              aria-label={visible ? "Sembunyikan kata sandi" : "Tampilkan kata sandi"}
              aria-pressed={visible}
              onClick={() => setVisible((v) => !v)}
            >
              {visible ? <EyeOffIcon /> : <EyeIcon />}
            </InputGroupButton>
          </InputGroupAddon>
        </InputGroup>
      </Field>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { ref, useId } from "vue"
import { EyeIcon, EyeOffIcon, SearchIcon } from "@lucide/vue"
import { Field, FieldLabel } from "@/components/ui/field"
import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput } from "@/components/ui/input-group"

const id = useId()
const visible = ref(false)
</script>

<template>
  <div class="grid w-full max-w-sm gap-6">
    <InputGroup>
      <InputGroupAddon>
        <SearchIcon />
      </InputGroupAddon>
      <InputGroupInput type="search" placeholder="Cari rilis" aria-label="Cari rilis" />
    </InputGroup>
    <Field>
      <FieldLabel :for="`${id}-password`">Kata sandi</FieldLabel>
      <InputGroup>
        <InputGroupInput :id="`${id}-password`" :type="visible ? 'text' : 'password'" autocomplete="current-password" />
        <InputGroupAddon align="inline-end">
          <InputGroupButton
            size="icon-xs"
            :aria-label="visible ? 'Sembunyikan kata sandi' : 'Tampilkan kata sandi'"
            :aria-pressed="visible"
            @click="visible = !visible"
          >
            <EyeOffIcon v-if="visible" />
            <EyeIcon v-else />
          </InputGroupButton>
        </InputGroupAddon>
      </InputGroup>
    </Field>
  </div>
</template>
```

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

class InputGroupDemo extends StatefulWidget {
  const InputGroupDemo({super.key});

  @override
  State<InputGroupDemo> createState() => _InputGroupDemoState();
}

class _InputGroupDemoState extends State<InputGroupDemo> {
  bool visible = false;

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 384),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        crossAxisAlignment: CrossAxisAlignment.stretch,
        spacing: 24,
        children: [
          const ShadInput(
            placeholder: Text('Cari rilis'),
            leading: Icon(LucideIcons.search, size: 16),
          ),
          ShadInputFormField(
            id: 'password',
            label: const Text('Kata sandi'),
            obscureText: !visible,
            trailing: Semantics(
              label: visible ? 'Sembunyikan kata sandi' : 'Tampilkan kata sandi',
              toggled: visible,
              child: ShadIconButton.ghost(
                width: 24,
                height: 24,
                icon: Icon(visible ? LucideIcons.eyeOff : LucideIcons.eye, size: 16),
                onPressed: () => setState(() => visible = !visible),
              ),
            ),
          ),
        ],
      ),
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Input tetap punya label sendiri: label yang terlihat di dalam Field, atau `aria-label` seperti "Cari rilis" untuk kolom cari yang hanya berikon.
- Tombol tampilkan kata sandi menyebut fungsinya: `aria-label` "Tampilkan kata sandi" / "Sembunyikan kata sandi", dengan `aria-pressed` selama kata sandi terlihat.
- Ikon di addon bersifat dekoratif dan tidak perlu label.
