# Slider

> Memilih nilai atau rentang di sebuah lintasan, misalnya awal dan akhir preview.

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

## 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](https://design.sosialoka.tech/id/components/input/).

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

## Anatomi

1. Track
2. Rentang terpilih
3. Thumb
4. Nilai

| 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.

## Props

| 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`.

## Kode

**React**
```tsx
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>
  )
}
```

**Vue**
```vue
<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>
```

**Flutter**
```dart
// 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

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

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

## Aksesibilitas

- 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.
