# Card

> Mengelompokkan isi yang saling terkait di permukaannya sendiri.

Card mengelompokkan isi yang saling terkait, misalnya satu rilisan atau satu dokumen, di permukaannya sendiri.

## Kapan dipakai

- Pakai untuk item yang berdiri sendiri, dengan judul dan biasanya aksi.
- Untuk membagi satu form atau halaman yang panjang, pakai section biasa, bukan card.
- Jangan menaruh card di dalam card.

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

### Lakukan dan jangan

- **Lakukan:** Pisahkan kartu dari halaman dengan garis tepi.
- **Jangan:** Jangan beri bayangan pada setiap kartu; bayangan hanya untuk yang melayang di atas halaman.

## Anatomi

1. Header: judul dan deskripsi
2. Isi
3. Footer dengan aksi

Header (judul, deskripsi, aksi opsional), isi, lalu footer berisi aksi. Card berlatar `card` dengan garis `border` dan `radius-lg` (12px). Bawaannya tanpa bayangan, karena garis tepi sudah memisahkannya dari halaman. Tambahkan `shadow-md` hanya untuk card yang melayang, seperti kartu header di dasbor.

## Varian

Hanya ada satu gaya. Tambahkan `shadow-md` untuk card yang melayang.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `CardHeader`, `CardTitle`, `CardDescription` | nama yang sama | `title`, `description` | elemen | tidak ada | Area judul. |
| `CardContent` | `CardContent` | `child` | elemen | tidak ada | Isi. |
| `CardFooter` | `CardFooter` | `footer` | elemen | tidak ada | Aksi. |
| `className` | `class` | `width`, `padding` | string | tidak ada | Ukuran dan bayangan melayang. |

## Kode

**React**
```tsx
import { Button } from "@/components/ui/button"
import {
  Card,
  CardContent,
  CardDescription,
  CardFooter,
  CardHeader,
  CardTitle,
} from "@/components/ui/card"

export default function CardDemo() {
  return (
    <Card className="w-full max-w-sm">
      <CardHeader>
        <CardTitle>Rilis baru</CardTitle>
        <CardDescription>Single "Senja di Kota" siap dikirim ke semua platform.</CardDescription>
      </CardHeader>
      <CardContent>
        <p className="text-sm text-muted-foreground">Periksa metadata dan artwork sebelum kamu kirim.</p>
      </CardContent>
      <CardFooter className="gap-2">
        <Button>Kirim</Button>
        <Button variant="outline">Periksa dulu</Button>
      </CardFooter>
    </Card>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Button } from "@/components/ui/button"
import {
  Card,
  CardContent,
  CardDescription,
  CardFooter,
  CardHeader,
  CardTitle,
} from "@/components/ui/card"
</script>

<template>
  <Card class="w-full max-w-sm">
    <CardHeader>
      <CardTitle>Rilis baru</CardTitle>
      <CardDescription>Single "Senja di Kota" siap dikirim ke semua platform.</CardDescription>
    </CardHeader>
    <CardContent>
      <p class="text-sm text-muted-foreground">Periksa metadata dan artwork sebelum kamu kirim.</p>
    </CardContent>
    <CardFooter class="gap-2">
      <Button>Kirim</Button>
      <Button variant="outline">Periksa dulu</Button>
    </CardFooter>
  </Card>
</template>
```

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

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

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return ShadCard(
      width: 384,
      title: Text('Rilis baru', style: theme.textTheme.h4),
      description: const Text('Single "Senja di Kota" siap dikirim ke semua platform.'),
      footer: Row(
        children: [
          ShadButton(onPressed: () {}, child: const Text('Kirim')),
          const SizedBox(width: 8),
          ShadButton.outline(onPressed: () {}, child: const Text('Periksa dulu')),
        ],
      ),
      child: const Padding(
        padding: EdgeInsets.symmetric(vertical: 16),
        child: Text('Periksa metadata dan artwork sebelum kamu kirim.'),
      ),
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Card hanyalah wadah. Kalau card memulai sebuah bagian, beri judulnya level heading yang benar di halamanmu.
- Cukup satu aksi utama per card, supaya footer-nya mudah dibaca.
