# Breadcrumb

> Menunjukkan letak halaman dan menautkan kembali ke induknya.

Breadcrumb menunjukkan jalur dari sebuah bagian ke halaman saat ini, dan menautkan setiap langkahnya kembali.

## Kapan dipakai

- Pakai di halaman yang dua tingkat atau lebih di dalam, misalnya metadata satu rilis.
- Taruh di atas judul halaman. Pola [Detail](https://design.sosialoka.tech/id/patterns/detail/) menunjukkan letaknya.
- Jangan pakai di halaman tingkat atas; sidebar sudah menunjukkan posisimu.

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

## Anatomi

1. Link ke halaman induk
2. Pemisah
3. Halaman saat ini

Tautan berukuran `text-sm text-muted-foreground`, dipisahkan chevron 14px. Halaman saat ini menjadi item terakhir, berwarna `text-foreground font-medium`, dan bukan tautan. Di bawah `sm`, ringkas level tengah menjadi ellipsis.

## Varian

Hanya ada satu gaya.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `BreadcrumbLink href` | `BreadcrumbLink href` | `ShadBreadcrumbLink onPressed` | tautan | tidak ada | Halaman induk. |
| `BreadcrumbPage` | `BreadcrumbPage` | `Text` | teks | tidak ada | Halaman saat ini, bukan tautan. |
| `BreadcrumbSeparator` | `BreadcrumbSeparator` | `separator` | elemen | chevron | Tanda di antara langkah. |
| `BreadcrumbEllipsis` | `BreadcrumbEllipsis` | `ShadBreadcrumbEllipsis` | elemen | tidak ada | Pengganti level tengah yang disembunyikan. |

## Kode

**React**
```tsx
import {
  Breadcrumb,
  BreadcrumbItem,
  BreadcrumbLink,
  BreadcrumbList,
  BreadcrumbPage,
  BreadcrumbSeparator,
} from "@/components/ui/breadcrumb"

export default function BreadcrumbDemo() {
  return (
    <Breadcrumb>
      <BreadcrumbList>
        <BreadcrumbItem>
          <BreadcrumbLink href="#">Rilis</BreadcrumbLink>
        </BreadcrumbItem>
        <BreadcrumbSeparator />
        <BreadcrumbItem>
          <BreadcrumbLink href="#">Senja di Kota</BreadcrumbLink>
        </BreadcrumbItem>
        <BreadcrumbSeparator />
        <BreadcrumbItem>
          <BreadcrumbPage>Ubah metadata</BreadcrumbPage>
        </BreadcrumbItem>
      </BreadcrumbList>
    </Breadcrumb>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import {
  Breadcrumb,
  BreadcrumbItem,
  BreadcrumbLink,
  BreadcrumbList,
  BreadcrumbPage,
  BreadcrumbSeparator,
} from "@/components/ui/breadcrumb"
</script>

<template>
  <Breadcrumb>
    <BreadcrumbList>
      <BreadcrumbItem>
        <BreadcrumbLink href="#">Rilis</BreadcrumbLink>
      </BreadcrumbItem>
      <BreadcrumbSeparator />
      <BreadcrumbItem>
        <BreadcrumbLink href="#">Senja di Kota</BreadcrumbLink>
      </BreadcrumbItem>
      <BreadcrumbSeparator />
      <BreadcrumbItem>
        <BreadcrumbPage>Ubah metadata</BreadcrumbPage>
      </BreadcrumbItem>
    </BreadcrumbList>
  </Breadcrumb>
</template>
```

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

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

  @override
  Widget build(BuildContext context) {
    return ShadBreadcrumb(
      children: [
        ShadBreadcrumbLink(onPressed: () {}, child: const Text('Rilis')),
        ShadBreadcrumbLink(onPressed: () {}, child: const Text('Senja di Kota')),
        // The current page is plain text, not a link.
        Semantics(selected: true, child: const Text('Ubah metadata')),
      ],
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Breadcrumb berupa `nav` bernama "breadcrumb", dengan langkah-langkahnya dalam daftar berurut.
- Halaman saat ini punya `aria-current="page"`.
- Pemisah disembunyikan dari pembaca layar.
