# Skeleton

> Placeholder berbentuk konten yang sedang dimuat.

Skeleton menggambar placeholder abu-abu berbentuk konten yang sedang dimuat, supaya halaman tidak melompat saat kontennya datang.

## Kapan dipakai

- Pakai kalau bentuk yang dimuat sudah diketahui: baris daftar, kartu, profil.
- Pakai [Spinner](https://design.sosialoka.tech/id/components/spinner/) untuk tunggu sebentar tanpa bentuk yang jelas, misalnya tombol yang sedang menyimpan.
- Samakan dengan tata letak aslinya: jumlah baris dan ukurannya kira-kira sama.

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

## Anatomi

1. Placeholder bentuk
2. Placeholder baris

Kotak berwarna `muted` dengan `radius-md` dan denyut halus `animate-pulse`. Kontainer yang sedang dimuat diberi `aria-busy="true"` dan teks khusus pembaca layar, misalnya "Memuat rilis…".

## Varian

Hanya ada satu gaya. Bentuknya diatur dengan kelas ukuran: `size-10` untuk avatar, `h-4 w-3/4` untuk sebaris teks.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `className` | `class` | `width`, `height` pada kotak `muted` | kelas | tidak ada | Ukuran dan bentuk. |

## Kode

**React**
```tsx
import { Skeleton } from "@/components/ui/skeleton"

export default function SkeletonDemo() {
  return (
    <div aria-busy="true" className="grid w-full max-w-sm gap-4">
      <span className="sr-only">Memuat rilis…</span>
      {[0, 1, 2].map((row) => (
        <div key={row} className="flex items-center gap-3">
          <Skeleton className="size-10" />
          <div className="grid flex-1 gap-2">
            <Skeleton className="h-4 w-3/4" />
            <Skeleton className="h-3 w-1/2" />
          </div>
        </div>
      ))}
    </div>
  )
}
```

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

<template>
  <div aria-busy="true" class="grid w-full max-w-sm gap-4">
    <span class="sr-only">Memuat rilis…</span>
    <div v-for="row in 3" :key="row" class="flex items-center gap-3">
      <Skeleton class="size-10" />
      <div class="grid flex-1 gap-2">
        <Skeleton class="h-4 w-3/4" />
        <Skeleton class="h-3 w-1/2" />
      </div>
    </div>
  </div>
</template>
```

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

// shadcn_ui has no skeleton: muted boxes with the md radius stand in, and the list says it is busy.
class Bone extends StatelessWidget {
  const Bone({super.key, required this.width, required this.height});

  final double width;
  final double height;

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return Container(
      width: width,
      height: height,
      decoration: BoxDecoration(color: theme.colorScheme.muted, borderRadius: theme.radius),
    );
  }
}

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

  @override
  Widget build(BuildContext context) {
    return Semantics(
      label: 'Memuat rilis…',
      child: ExcludeSemantics(
        child: Column(
          mainAxisSize: MainAxisSize.min,
          spacing: 16,
          children: [
            for (var row = 0; row < 3; row++)
              const Row(
                mainAxisSize: MainAxisSize.min,
                spacing: 12,
                children: [
                  Bone(width: 40, height: 40),
                  Column(
                    crossAxisAlignment: CrossAxisAlignment.start,
                    spacing: 8,
                    children: [Bone(width: 240, height: 16), Bone(width: 160, height: 12)],
                  ),
                ],
              ),
          ],
        ),
      ),
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Taruh `aria-busy="true"` di kontainer yang sedang dimuat, dan hapus saat kontennya sudah ada.
- Beri pembaca layar satu teks untuk seluruh placeholder, misalnya "Memuat rilis…", dan sembunyikan kotak-kotaknya.
- Denyutnya berhenti saat `prefers-reduced-motion` aktif.
