# Separator

> Garis tipis di antara kelompok.

Separator menggambar garis tipis di antara kelompok isi, misalnya bagian-bagian kartu atau menu.

## Kapan dipakai

- Pakai di antara kelompok yang masih satu kesatuan tapi dibaca terpisah, misalnya profil dan statistik di kartu artis.
- Utamakan jarak dulu; tambahkan garis hanya kalau jarak saja belum cukup memisahkan.
- Pakai `vertical` di antara item dalam satu baris, misalnya tombol toolbar.

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

## Anatomi

1. Pemisah horizontal
2. Pemisah vertikal

Garis 1px berwarna `border`, mendatar secara bawaan.

## Varian

| Orientasi | Pakai untuk |
| --- | --- |
| `horizontal` (bawaan) | Di antara kelompok yang bertumpuk. |
| `vertical` | Di antara item dalam satu baris. |

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `orientation` | `orientation` | `ShadSeparator.horizontal` / `.vertical` | teks | `horizontal` | Arah garis. |
| selalu `role="separator"` | `decorative` | tidak dibacakan | boolean | `true` di Vue | Apakah pembaca layar mendengarnya. |

## Kode

**React**
```tsx
import { Separator } from "@/components/ui/separator"

export default function SeparatorDemo() {
  return (
    <div className="w-full max-w-xs rounded-lg border border-border bg-card p-4 text-sm">
      <p className="font-medium">Rara Senandika</p>
      <p className="text-muted-foreground">Penyanyi pop, Bandung</p>
      <Separator className="my-3" />
      <p className="text-muted-foreground">3 rilis · 12.480 pendengar bulanan</p>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Separator } from "@/components/ui/separator"
</script>

<template>
  <div class="w-full max-w-xs rounded-lg border border-border bg-card p-4 text-sm">
    <p class="font-medium">Rara Senandika</p>
    <p class="text-muted-foreground">Penyanyi pop, Bandung</p>
    <Separator :decorative="false" class="my-3" />
    <p class="text-muted-foreground">3 rilis · 12.480 pendengar bulanan</p>
  </div>
</template>
```

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

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

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return SizedBox(
      width: 320,
      child: ShadCard(
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text('Rara Senandika', style: theme.textTheme.small),
            Text('Penyanyi pop, Bandung', style: theme.textTheme.muted),
            const ShadSeparator.horizontal(margin: EdgeInsets.symmetric(vertical: 12)),
            Text('3 rilis · 12.480 pendengar bulanan', style: theme.textTheme.muted),
          ],
        ),
      ),
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Separator di antara bagian yang sungguhan punya `role="separator"`; garis yang hanya hiasan disembunyikan dari pembaca layar (`decorative` di Vue).
- Separator tidak pernah menerima fokus.
