# Table

> Menampilkan data dalam baris dan kolom, dengan tata letak datatable bersama dan paginasi.

Tabel menampilkan data dalam baris dan kolom. Semua produk Sosialoka menyusun datatable-nya dengan cara yang sama.

## Kapan dipakai

- Pakai untuk data yang dibandingkan atau dipindai, misalnya rilisan, dokumen, atau pembayaran.
- Pakai card untuk sedikit item yang kaya isi, dan daftar biasa untuk satu kolom teks.

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

### Lakukan dan jangan

- **Lakukan:** Rata kanankan angka dengan angka tabular, supaya digitnya sejajar.
- **Jangan:** Jangan tengahkan angka; besar-kecilnya jadi sulit dibandingkan.

## Anatomi

1. Baris header di muted
2. Baris
3. Badge status

Datatable bersama punya empat bagian:

1. **Header**: nama kolom berwarna `muted-foreground`, tebal medium.
2. **Baris**: garis `border-b border-border` antarbaris, `bg-muted/50` saat di-hover. Status memakai [Badge](https://design.sosialoka.tech/id/components/badge/).
3. **Aksi baris**: tombol ikon ghost yang membuka [Dropdown Menu](https://design.sosialoka.tech/id/components/dropdown-menu/), di kolom terakhir.
4. **Paginasi**: di bawah tabel, di dalam kartu yang sama. Halaman yang sedang dibuka memakai tombol `outline`.

Taruh tabel di dalam kartu (`rounded-lg border border-border bg-card`) supaya terbaca sebagai satu permukaan.

## Varian

Hanya ada satu gaya. Tambahkan `text-right` dan `tabular-nums` ke kolom angka.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `Table`, `TableHeader`, `TableBody`, `TableRow`, `TableHead`, `TableCell` | nama yang sama | `ShadTable.list`, `ShadTableCell` | elemen | tidak ada | Struktur tabel. |
| `PaginationLink isActive` | `PaginationItem :is-active` | `ShadButton.outline` | boolean | `false` | Menandai halaman yang dibuka. |
| `href` di link paginasi | `:total`, `:items-per-page` di `Pagination` | tidak ada | string / angka | tidak ada | Tujuan link halaman, atau cara Vue menghitung halaman. |

## Kode

**React**
```tsx
import { useState, type MouseEvent } from "react"
import { Badge } from "@/components/ui/badge"
import {
  Pagination,
  PaginationContent,
  PaginationItem,
  PaginationLink,
  PaginationNext,
  PaginationPrevious,
} from "@/components/ui/pagination"
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table"

const releases = [
  { title: "Senja di Kota", artist: "Rara Senandika", status: "success", label: "Terbit" },
  { title: "Kaset Pertama", artist: "Bima Laras", status: "warning", label: "Menunggu" },
  { title: "Pulang Sore", artist: "Nada Kirana", status: "info", label: "Dijadwalkan" },
  { title: "Hujan Bulan Juni", artist: "Arka Wening", status: "success", label: "Terbit" },
  { title: "Lampu Kota", artist: "Sinta Maharani", status: "destructive", label: "Ditolak" },
] as const

/** Two pages of five rows; the demo shows the first page's rows on both. */
const pages = [1, 2]

export default function TableDemo() {
  const [page, setPage] = useState(1)
  const goTo = (next: number) => (event: MouseEvent) => {
    event.preventDefault()
    setPage(next)
  }
  return (
    <div className="w-full max-w-xl rounded-lg border border-border bg-card">
      <Table>
        <TableHeader>
          <TableRow>
            <TableHead>Judul</TableHead>
            <TableHead>Artis</TableHead>
            <TableHead>Status</TableHead>
          </TableRow>
        </TableHeader>
        <TableBody>
          {releases.map((r) => (
            <TableRow key={r.title}>
              <TableCell className="font-medium">{r.title}</TableCell>
              <TableCell className="text-muted-foreground">{r.artist}</TableCell>
              <TableCell>
                <Badge variant={r.status}>{r.label}</Badge>
              </TableCell>
            </TableRow>
          ))}
        </TableBody>
      </Table>
      <Pagination className="border-t border-border py-2">
        <PaginationContent>
          <PaginationItem>
            <PaginationPrevious href="#" disabled={page === 1} onClick={goTo(page - 1)} />
          </PaginationItem>
          {pages.map((p) => (
            <PaginationItem key={p}>
              <PaginationLink href="#" isActive={p === page} onClick={goTo(p)}>
                {p}
              </PaginationLink>
            </PaginationItem>
          ))}
          <PaginationItem>
            <PaginationNext href="#" disabled={page === pages.length} onClick={goTo(page + 1)} />
          </PaginationItem>
        </PaginationContent>
      </Pagination>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Badge } from "@/components/ui/badge"
import {
  Pagination,
  PaginationContent,
  PaginationItem,
  PaginationNext,
  PaginationPrevious,
} from "@/components/ui/pagination"
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table"

const releases = [
  { title: "Senja di Kota", artist: "Rara Senandika", status: "success", label: "Terbit" },
  { title: "Kaset Pertama", artist: "Bima Laras", status: "warning", label: "Menunggu" },
  { title: "Pulang Sore", artist: "Nada Kirana", status: "info", label: "Dijadwalkan" },
  { title: "Hujan Bulan Juni", artist: "Arka Wening", status: "success", label: "Terbit" },
  { title: "Lampu Kota", artist: "Sinta Maharani", status: "destructive", label: "Ditolak" },
] as const
</script>

<template>
  <div class="w-full max-w-xl rounded-lg border border-border bg-card">
    <Table>
      <TableHeader>
        <TableRow>
          <TableHead>Judul</TableHead>
          <TableHead>Artis</TableHead>
          <TableHead>Status</TableHead>
        </TableRow>
      </TableHeader>
      <TableBody>
        <TableRow v-for="r in releases" :key="r.title">
          <TableCell class="font-medium">{{ r.title }}</TableCell>
          <TableCell class="text-muted-foreground">{{ r.artist }}</TableCell>
          <TableCell><Badge :variant="r.status">{{ r.label }}</Badge></TableCell>
        </TableRow>
      </TableBody>
    </Table>
    <Pagination v-slot="{ page }" :items-per-page="5" :total="10" :default-page="1" class="border-t border-border py-2">
      <PaginationContent v-slot="{ items }">
        <PaginationPrevious />
        <template v-for="(item, index) in items" :key="index">
          <PaginationItem v-if="item.type === 'page'" :value="item.value" :is-active="item.value === page">
            {{ item.value }}
          </PaginationItem>
        </template>
        <PaginationNext />
      </PaginationContent>
    </Pagination>
  </div>
</template>
```

**Flutter**
```dart
// shadcn_ui has no pagination widget: put ShadButton.outline (current page) and ShadButton.ghost below the table.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const releases = [
  (title: 'Senja di Kota', artist: 'Rara Senandika', status: 'Terbit'),
  (title: 'Kaset Pertama', artist: 'Bima Laras', status: 'Menunggu'),
  (title: 'Pulang Sore', artist: 'Nada Kirana', status: 'Dijadwalkan'),
];

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

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 576, maxHeight: 320),
      child: ShadTable.list(
        // Fixed widths for the title and artist; the status column takes the rest, so badges never clip.
        columnSpanExtent: (index) => switch (index) {
          0 => const FixedTableSpanExtent(200),
          1 => const FixedTableSpanExtent(180),
          _ => const RemainingTableSpanExtent(),
        },
        header: const [
          ShadTableCell.header(child: Text('Judul')),
          ShadTableCell.header(child: Text('Artis')),
          ShadTableCell.header(child: Text('Status')),
        ],
        children: releases.map(
          (r) => [
            ShadTableCell(child: Text(r.title, style: const TextStyle(fontWeight: FontWeight.w500))),
            ShadTableCell(child: Text(r.artist)),
            ShadTableCell(child: ShadBadge.outline(child: Text(r.status))),
          ],
        ),
      ),
    );
  }
}
```

## Pasang

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

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

Paginasi adalah item terpisah:

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

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

## Aksesibilitas

- Memakai `table`, `th`, dan `td` asli, jadi screen reader membacakan baris dan kolomnya.
- Paginasi adalah `nav`, dan halaman yang dibuka punya `aria-current="page"`.
- Beri aksi baris berisi ikon saja sebuah `aria-label`, misalnya "Aksi".
