Item
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
Section titled “Kapan dipakai”- Pakai untuk daftar di HP dan di panel: artis, rilis, menu akun, pengaturan.
- Pakai 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.
RS
Rara Senandika
3 rilis · Pop
BL
Bima Laras
5 rilis · Folk
NK
Nada Kirana
2 rilis · R&B
RS
Rara Senandika
3 rilis · Pop
BL
Bima Laras
5 rilis · Folk
NK
Nada Kirana
2 rilis · R&B
Anatomi
Section titled “Anatomi”- 1Avatar atau ikon di depan
- 2Judul dan keterangan
- 3Chevron di belakang
- 4Pemisah
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
Section titled “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. |
| 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. |
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> )}<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>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
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/item.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/item.jsonAksesibilitas
Section titled “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.
