Lewati ke konten

Slider

Unduh .md

Slider memilih sebuah nilai, atau rentang dengan dua pegangan, dengan menggeser di sepanjang lintasan, misalnya bagian lagu yang dipakai sebagai preview.

  • Pakai saat posisi kira-kira lebih penting daripada angka pastinya: jendela preview, volume.
  • Selalu tampilkan nilainya sebagai teks di dekatnya, misalnya “0:30–1:00 dari 3:20”.
  • Kalau angkanya harus tepat, misalnya harga atau persentase di kontrak, pakai Input.
React

Potong preview

0:30–1:00 dari 3:20

Vue

Potong preview

0:30–1:00 dari 3:20

1234
  1. 1Track
  2. 2Rentang terpilih
  3. 3Thumb
  4. 4Nilai
Bagian Gaya
Lintasan 6px (h-1.5), rounded-full, bg-muted
Rentang bg-primary
Pegangan 16px (size-4), rounded-full, border primary di atas background

Dengan dua pegangan, keduanya tidak pernah saling melewati.

React Vue Flutter Tipe Bawaan Kegunaan
value, onValueChange v-model ShadSlider initialValue, onChanged number[] / number tidak ada Nilainya, atau awal dan akhir rentang.
min, max, step sama min, max, divisions number 0, 100, 1 Batas dan langkahnya.
getAriaLabel get-aria-label Semantics label fungsi tidak ada Nama tiap pegangan, misalnya “Awal” dan “Akhir”.
getAriaValueText get-aria-value-text semanticFormatterCallback fungsi angkanya Yang dibacakan pembaca layar, misalnya “1:05”.

shadcn_ui hanya punya satu pegangan; untuk rentang di Flutter, pakai RangeSlider Material di dalam SosialokaTheme.material.

import { useState } from "react"
import { Slider } from "@/components/ui/slider"
const time = (seconds: number) => `${Math.floor(seconds / 60)}:${String(seconds % 60).padStart(2, "0")}`
export default function SliderDemo() {
const [range, setRange] = useState([30, 60])
return (
<div className="flex w-full max-w-sm flex-col gap-3">
<div className="flex items-baseline justify-between text-sm">
<p id="preview-label" className="font-medium">
Potong preview
</p>
<p className="text-muted-foreground tabular-nums">
{time(range[0])}–{time(range[1])} dari 3:20
</p>
</div>
<Slider
aria-labelledby="preview-label"
value={range}
onValueChange={(value) => setRange(value as number[])}
max={200}
getAriaLabel={(index) => (index === 0 ? "Awal" : "Akhir")}
getAriaValueText={(_, value) => time(value)}
/>
</div>
)
}
Terminal window
npx shadcn@latest add https://design.sosialoka.tech/r/react/slider.json
  • Setiap pegangan adalah slider dengan nama dan nilai yang dibacakan, misalnya “Awal, 0:30”.
  • Tombol panah bergeser satu langkah, Page Up dan Page Down sepuluh, Home dan End ke ujung.
  • Nilainya juga tampil sebagai teks, jadi tidak perlu menggeser untuk membacanya.