# Item

> Baris daftar dengan media, judul, deskripsi, dan aksi.

Item adalah satu baris di daftar: gambar atau ikon, judul, satu baris deskripsi, dan aksi, misalnya artis di daftar atau pengaturan di menu.

## Kapan dipakai

- Pakai untuk daftar di HP dan di panel: artis, rilis, menu akun, pengaturan.
- Pakai [Table](https://design.sosialoka.tech/id/components/table/) untuk data dengan banyak kolom yang dibandingkan.
- Jadikan seluruh baris tautan kalau membuka halaman; pakai tombol terpisah kalau baris punya aksi sendiri.
- Item menjadi baris di pola [Aplikasi mobile](https://design.sosialoka.tech/id/patterns/mobile-app/).

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

## Anatomi

1. Avatar atau ikon di depan
2. Judul dan keterangan
3. Chevron di belakang
4. Pemisah

Baris dengan `radius-lg`, `p-3`, dan jarak 12px: media di kiri (Avatar atau ikon 40px), judul (`text-sm font-medium`) dan deskripsi (`text-sm text-muted-foreground`), lalu aksi di kanan. Sebagai tautan, warnanya berubah `accent` saat disorot.

## Varian

| Varian | Pakai untuk |
| --- | --- |
| `default` | Baris di menu atau daftar dengan pemisah. |
| `outline` | Baris yang berdiri sendiri, misalnya kartu di daftar. |
| `muted` | Baris yang butuh permukaan tenang, misalnya ringkasan. |

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `variant` | `variant` | `ShadItem` / `.outline` / `.muted` | teks | `default` | Tampilan. |
| `size` | `size` | `size` | `default`, `sm`, `xs` (khusus React) | `default` | Padding. |
| `render={<a href />}` | `as-child` dengan tautan | `onPressed` | elemen | `div` | Menjadikan seluruh baris tautan. |
| `ItemMedia`, `ItemTitle`, `ItemDescription`, `ItemActions` | sama | `media`, `title`, `description`, `actions` | elemen | tidak ada | Bagian-bagian baris. |

## Kode

**React**
```tsx
import { Avatar, AvatarFallback } from "@/components/ui/avatar"
import { Button } from "@/components/ui/button"
import { Item, ItemActions, ItemContent, ItemDescription, ItemGroup, ItemMedia, ItemTitle } from "@/components/ui/item"

const artists = [
  { name: "Rara Senandika", initials: "RS", detail: "3 rilis · Pop" },
  { name: "Bima Laras", initials: "BL", detail: "5 rilis · Folk" },
  { name: "Nada Kirana", initials: "NK", detail: "2 rilis · R&B" },
]

export default function ItemDemo() {
  return (
    <ItemGroup className="w-full max-w-md gap-2">
      {artists.map((artist) => (
        <Item key={artist.name} variant="outline">
          <ItemMedia>
            <Avatar>
              <AvatarFallback>{artist.initials}</AvatarFallback>
            </Avatar>
          </ItemMedia>
          <ItemContent>
            <ItemTitle>{artist.name}</ItemTitle>
            <ItemDescription>{artist.detail}</ItemDescription>
          </ItemContent>
          <ItemActions>
            <Button variant="outline" size="sm" aria-label={`Lihat ${artist.name}`}>
              Lihat
            </Button>
          </ItemActions>
        </Item>
      ))}
    </ItemGroup>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Avatar, AvatarFallback } from "@/components/ui/avatar"
import { Button } from "@/components/ui/button"
import { Item, ItemActions, ItemContent, ItemDescription, ItemGroup, ItemMedia, ItemTitle } from "@/components/ui/item"

const artists = [
  { name: "Rara Senandika", initials: "RS", detail: "3 rilis · Pop" },
  { name: "Bima Laras", initials: "BL", detail: "5 rilis · Folk" },
  { name: "Nada Kirana", initials: "NK", detail: "2 rilis · R&B" },
]
</script>

<template>
  <ItemGroup class="w-full max-w-md gap-2">
    <Item v-for="artist in artists" :key="artist.name" variant="outline">
      <ItemMedia>
        <Avatar>
          <AvatarFallback>{{ artist.initials }}</AvatarFallback>
        </Avatar>
      </ItemMedia>
      <ItemContent>
        <ItemTitle>{{ artist.name }}</ItemTitle>
        <ItemDescription>{{ artist.detail }}</ItemDescription>
      </ItemContent>
      <ItemActions>
        <Button variant="outline" size="sm" :aria-label="`Lihat ${artist.name}`">Lihat</Button>
      </ItemActions>
    </Item>
  </ItemGroup>
</template>
```

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

const itemArtists = [('Rara Senandika', 'RS', '3 rilis · Pop'), ('Bima Laras', 'BL', '5 rilis · Folk'), ('Nada Kirana', 'NK', '2 rilis · R&B')];

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

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 448),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        spacing: 8,
        children: [
          for (final (name, initials, detail) in itemArtists)
            ShadItem.outline(
              media: ShadAvatar(null, placeholder: Text(initials)),
              title: Text(name),
              description: Text(detail),
              actions: Semantics(
                label: 'Lihat $name',
                button: true,
                child: ExcludeSemantics(child: ShadButton.outline(size: ShadButtonSize.sm, onPressed: () {}, child: const Text('Lihat'))),
              ),
            ),
        ],
      ),
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Beri nama setiap aksi beserta objeknya: "Lihat Rara Senandika", bukan hanya "Lihat".
- Kalau seluruh baris berupa tautan, jangan taruh tombol lain di dalamnya.
- Taruh item di dalam daftar (`ItemGroup`) supaya pembaca layar menyebut jumlahnya.
