Lewati ke konten

Carousel

Unduh .md

Carousel menampilkan deretan kartu yang bisa digeser, misalnya rilis terbaru atau sorotan di layar beranda.

  • Pakai untuk konten yang boleh terlewat, misalnya rilis atau sorotan.
  • Jangan taruh informasi wajib di dalamnya: yang ada di luar layar mungkin tidak pernah terlihat.
  • Jangan pakai autoplay.
  • Tampilkan tepi kartu berikutnya, supaya orang tahu masih ada lagi.
React

Senja di Kota

Rara Senandika

Kaset Pertama

Bima Laras

Pulang Sore

Nada Kirana

Hujan Bulan Juni

Arka Wening

Lampu Kota

Sinta Maharani

Vue

Senja di Kota

Rara Senandika

Kaset Pertama

Bima Laras

Pulang Sore

Nada Kirana

Hujan Bulan Juni

Arka Wening

Lampu Kota

Sinta Maharani

123
  1. 1Slide saat ini
  2. 2Slide berikutnya, terlihat sebagian
  3. 3Titik posisi

Kartu berderet dengan jarak 16px, plus tombol sebelumnya dan berikutnya outline berbentuk kotak (bukan pil) yang nonaktif di ujung. Di HP tombolnya disembunyikan dan orang cukup menggeser; halaman tidak pernah bergulir ke samping.

Di HP, CarouselDots di bawah deretan kartu boleh menunjukkan posisi, karena orang menggeser tanpa melihat tombol:

  • Satu titik per perhentian: 6px, radius-full, berjarak 4px, di tengah 12px di bawah kartu.
  • Titik slide yang sedang tampil selebar 20px dengan warna primary; sisanya input.
  • Pakai titik untuk maksimal 5 slide. Lebih dari itu, jangan pakai titik.
  • Titik hanya menunjukkan posisi. Titik bukan tombol, dan pembaca layar melewatinya.
React Vue Flutter Tipe Bawaan Kegunaan
opts :opts PageController(viewportFraction: 0.85) opsi Embla tidak ada Misalnya { align: "start" }.
CarouselItem aria-label sama Semantics label teks tidak ada Posisi slide, misalnya “1 dari 5”.
CarouselPrevious label, CarouselNext label sama Semantics label teks Previous slide, Next slide Nama tombol, misalnya “Sebelumnya”.
CarouselDots max CarouselDots :max baris titik (lihat kode Flutter) angka 5 Titik posisi untuk HP; kalau perhentiannya lebih dari ini, titik tidak tampil.
setApi @init-api controller-nya fungsi tidak ada Membaca atau menggeser carousel dari luar.
import { MusicIcon } from "lucide-react"
import { Carousel, CarouselContent, CarouselDots, CarouselItem, CarouselNext, CarouselPrevious } from "@/components/ui/carousel"
const releases = [
{ title: "Senja di Kota", artist: "Rara Senandika" },
{ title: "Kaset Pertama", artist: "Bima Laras" },
{ title: "Pulang Sore", artist: "Nada Kirana" },
{ title: "Hujan Bulan Juni", artist: "Arka Wening" },
{ title: "Lampu Kota", artist: "Sinta Maharani" },
]
export default function CarouselDemo() {
return (
<Carousel aria-label="Rilis terbaru" opts={{ align: "start" }} className="w-full max-w-md sm:mx-12">
<CarouselContent>
{releases.map((r, i) => (
<CarouselItem key={r.title} aria-label={`${i + 1} dari ${releases.length}`} className="basis-2/3 sm:basis-1/2">
<div className="flex flex-col gap-2">
<div className="flex aspect-square items-center justify-center rounded-lg bg-muted">
<MusicIcon aria-hidden="true" className="size-6 text-muted-foreground" />
</div>
<div className="text-sm">
<p className="truncate font-medium">{r.title}</p>
<p className="truncate text-muted-foreground">{r.artist}</p>
</div>
</div>
</CarouselItem>
))}
</CarouselContent>
<CarouselPrevious label="Sebelumnya" />
<CarouselNext label="Berikutnya" />
<CarouselDots />
</Carousel>
)
}
Terminal window
npx shadcn@latest add https://design.sosialoka.tech/r/react/carousel.json
  • Carousel adalah region dengan aria-roledescription="carousel"; beri nama, misalnya “Rilis terbaru”.
  • Setiap slide adalah group dengan aria-roledescription="slide" dan label seperti “1 dari 5”.
  • Tombol sebelumnya dan berikutnya diberi nama dan nonaktif di ujung.
  • Titik diberi aria-hidden; posisi disampaikan lewat label slide, misalnya “1 dari 3”.
  • Tombol panah kiri dan kanan berpindah slide saat fokus ada di dalamnya.