Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Slider

    Slider rentang dari input type range native, dengan isian primary, thumb bulat, dan nilai saat ini di samping label.

    <div class="grid gap-6">
        <x-markas.slider name="volume" label="Volume" :value="60" />
        <x-markas.slider name="brightness" label="Brightness" :step="10" :value="30" />
    </div>
    import { Slider } from "@/components/markas/Slider";
    
    export default function SliderExample() {
      return (
        <div className="grid gap-6">
          <Slider name="volume" label="Volume" defaultValue={60} />
          <Slider
            name="brightness"
            label="Brightness"
            step={10}
            defaultValue={30}
          />
        </div>
      );
    }
    <script setup lang="ts">
    import Slider from "@/components/markas/Slider.vue";
    </script>
    
    <template>
      <div class="grid gap-6">
        <Slider name="volume" label="Volume" :default-value="60" />
        <Slider
          name="brightness"
          label="Brightness"
          :step="10"
          :default-value="30"
        />
      </div>
    </template>
    <script lang="ts">
      import Slider from "$lib/components/markas/Slider.svelte";
    </script>
    
    <div class="grid gap-6">
      <Slider name="volume" label="Volume" value={60} />
      <Slider name="brightness" label="Brightness" step={10} value={30} />
    </div>
    ---
    import Slider from "@/components/markas/Slider.astro";
    ---
    
    <div class="grid gap-6">
      <Slider name="volume" label="Volume" value={60} />
      <Slider name="brightness" label="Brightness" step={10} value={30} />
    </div>
    import { Component } from "@angular/core";
    import { Slider } from "./markas/slider.component";
    
    @Component({
      selector: "markas-example",
      imports: [Slider],
      template: `
        <div class="grid gap-6">
          <markas-slider name="volume" label="Volume" value="60" />
          <markas-slider
            name="brightness"
            label="Brightness"
            step="10"
            value="30"
          />
        </div>
      `,
    })
    export default class SliderFixture {}

    Contoh

    Label rentang

    0 500
    0500
    0500
    0 500
    0500

    Status

    Dengan ikon

    Dalam kartu

    Sound

    Changes apply to every device on this account.

    Sound

    Changes apply to every device on this account.

    Sound

    Changes apply to every device on this account.

    Sound

    Changes apply to every device on this account.

    Sound

    Changes apply to every device on this account.

    Instalasi

    npx markasui@latest add slider

    Pemakaian

    <x-markas.slider name="volume" label="Volume" :value="60" />
    <x-markas.slider name="anggaran" label="Anggaran" :min="0" :max="500" :step="25" :value="250" />

    Butuh Alpine.js untuk memperbarui isian dan nilai saat digeser.

    Livewire

    <x-markas.slider label="Volume" wire:model.live="volume" />

    wire:model terhubung ke nilai slider lewat x-modelable di pembungkus, jadi label angka ikut berubah saat server mengubah nilai. Pakai wire:model.live.debounce.300ms agar request lebih sedikit saat menggeser. Atribut lain jatuh ke input range.

    import { Slider } from "@/components/markas/Slider";
    
    <Slider
      name="volume"
      label="Volume"
      defaultValue={60}
      onValueChange={(value) => console.log(value)}
    />;
    <script setup lang="ts">
    import { ref } from "vue";
    import Slider from "@/components/markas/Slider.vue";
    
    const volume = ref(60);
    </script>
    
    <template>
      <Slider v-model="volume" name="volume" label="Volume" />
    </template>
    <script lang="ts">
      import Slider from "$lib/components/markas/Slider.svelte";
    
      let volume = $state(60);
    </script>
    
    <Slider bind:value={volume} name="volume" label="Volume suara" />
    <Slider name="budget" label="Anggaran" max={500} step={25} value={250} />
    ---
    import Slider from "@/components/markas/Slider.astro";
    ---
    
    <Slider name="volume" label="Volume suara" value={60} />

    Script kecil di halaman memperbarui isian dan angka saat digeser.

    import { Component, signal } from "@angular/core";
    import { Slider } from "./markas/slider.component";
    
    @Component({
      selector: "app-suara",
      imports: [Slider],
      template: `
        <markas-slider [(value)]="volume" name="volume" label="Volume suara" />
        <markas-slider
          name="budget"
          label="Anggaran"
          max="500"
          step="25"
          value="250"
        />
      `,
    })
    export class Suara {
      readonly volume = signal(60);
    }
    • Slider adalah <input type="range">, jadi nilainya ikut terkirim bersama form dan keyboard bekerja secara native.
    • Isian berasal dari variabel CSS --value (persentase) yang diperbarui komponen setiap kali digeser.
    • Tanpa label yang terlihat, isi aria-label dan matikan showValue kalau angkanya tidak perlu.
    • Komponen ini tidak punya teks bawaan. Cukup isi label dalam Bahasa Indonesia.

    Props

    NamaTipeDefaultKeterangan
    labelstring-Teks label di atas slider, terhubung lewat for/id. Tanpa label, isi aria-label.
    minnumber0Nilai terendah.
    maxnumber100Nilai tertinggi.
    stepnumber1Kenaikan nilai saat digeser dan saat memakai tombol panah.
    value / defaultValue / v-model / bind:valuenumberminNilai saat ini. Blade dan Astro memakai value, React value atau defaultValue, Vue v-model atau defaultValue, Svelte bind:value, Angular value atau [(value)].
    onValueChange(value: number) => void-Khusus React. Dipanggil dengan angka baru setiap kali digeser.
    valueChangeoutput<number>-Khusus Angular. Memancarkan angka baru setiap kali digeser.
    showValuebooleantrueMenampilkan nilai saat ini di kanan label dengan angka tabular.
    disabledbooleanfalseMenonaktifkan slider dan meredupkan label.
    idstringautoId input. Dibuat otomatis kalau kosong.

    Aksesibilitas

    • Input type range native, sehingga screen reader membacakan peran slider dan nilainya.
    • Tombol panah, Page Up, Page Down, Home, dan End mengubah nilai secara native.
    • Nilai yang tampil diberi aria-hidden karena slider sudah membacakannya.

    Komponen terkait

    Komponen form lain dengan class yang sama di setiap framework.