Slider
Slider memilih sebuah nilai, atau rentang dengan dua pegangan, dengan menggeser di sepanjang lintasan, misalnya bagian lagu yang dipakai sebagai preview.
Kapan dipakai
Section titled “Kapan dipakai”- 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.
Potong preview
0:30–1:00 dari 3:20
Potong preview
0:30–1:00 dari 3:20
Anatomi
Section titled “Anatomi”- 1Track
- 2Rentang terpilih
- 3Thumb
- 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> )}<script setup lang="ts">import { ref } from "vue"import { Slider } from "@/components/ui/slider"
const range = ref([30, 60])const time = (seconds: number) => `${Math.floor(seconds / 60)}:${String(seconds % 60).padStart(2, "0")}`</script>
<template> <div class="flex w-full max-w-sm flex-col gap-3"> <div class="flex items-baseline justify-between text-sm"> <p id="preview-label" class="font-medium"> Potong preview </p> <p class="text-muted-foreground tabular-nums"> {{ time(range[0]) }}–{{ time(range[1]) }} dari 3:20 </p> </div> <Slider v-model="range" aria-labelledby="preview-label" :max="200" :get-aria-label="(index) => (index === 0 ? 'Awal' : 'Akhir')" :get-aria-value-text="(value) => time(value)" /> </div></template>// ShadSlider has one thumb. For a range (start and end of a preview), use Material's RangeSlider inside// SosialokaTheme.material, whose slider colors come from the same tokens.import 'package:flutter/widgets.dart';import 'package:shadcn_ui/shadcn_ui.dart';
String _time(double seconds) => '${seconds ~/ 60}:${(seconds % 60).toInt().toString().padLeft(2, '0')}';
class SliderDemo extends StatefulWidget { const SliderDemo({super.key});
@override State<SliderDemo> createState() => _SliderDemoState();}
class _SliderDemoState extends State<SliderDemo> { double start = 30;
@override Widget build(BuildContext context) { final theme = ShadTheme.of(context); return ConstrainedBox( constraints: const BoxConstraints(maxWidth: 384), child: Column( mainAxisSize: MainAxisSize.min, children: [ Row( children: [ const Expanded(child: Text('Awal preview', style: TextStyle(fontWeight: FontWeight.w500))), Text('${_time(start)} dari 3:20', style: theme.textTheme.muted), ], ), const SizedBox(height: 12), ShadSlider( initialValue: start, max: 200, divisions: 200, semanticFormatterCallback: _time, onChanged: (value) => setState(() => start = value), ), ], ), ); }}Instal
Section titled “Instal”npx shadcn@latest add https://design.sosialoka.tech/r/react/slider.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/slider.jsonAksesibilitas
Section titled “Aksesibilitas”- Setiap pegangan adalah
sliderdengan 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.
