Skip to content
MarkasUI
Type to search

    Guide

    MarkasUI

    Form

    Feedback

    Overlay

    Navigation

    Data

    Sections

    Animations

    Backgrounds

    Buttons

    Templates

    Pages

    Slider

    Range slider built on a native input type range, with a primary fill, a round thumb, and the current value shown next to the 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 {}

    Examples

    Range labels

    0 500
    0500
    0500
    0 500
    0500

    States

    With icons

    In a card

    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.

    Installation

    npx markasui@latest add slider

    Usage

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

    Needs Alpine.js to update the fill and the value while dragging.

    Livewire

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

    wire:model binds to the slider value through x-modelable on the wrapper, so the number label follows server changes too. Use wire:model.live.debounce.300ms to send fewer requests while dragging. Other attributes land on the range input.

    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" />
    <Slider name="budget" label="Budget" max={500} step={25} value={250} />
    ---
    import Slider from "@/components/markas/Slider.astro";
    ---
    
    <Slider name="volume" label="Volume" value={60} />

    A small page script updates the fill and the value while dragging.

    import { Component, signal } from "@angular/core";
    import { Slider } from "./markas/slider.component";
    
    @Component({
      selector: "app-sound",
      imports: [Slider],
      template: `
        <markas-slider [(value)]="volume" name="volume" label="Volume" />
        <markas-slider
          name="budget"
          label="Budget"
          max="500"
          step="25"
          value="250"
        />
      `,
    })
    export class Sound {
      readonly volume = signal(60);
    }
    • Slider is an <input type="range">, so its value is submitted with the form and the keyboard works natively.
    • The fill comes from the CSS variable --value (a percentage) that the component updates on every input.
    • Without a visible label, pass aria-label and set showValue to false if the number is not needed.
    • The component has no built-in text. Translate label directly.

    Props

    NameTypeDefaultDescription
    labelstring-Label text above the slider, linked through for/id. Without it, pass aria-label.
    minnumber0Lowest value.
    maxnumber100Highest value.
    stepnumber1Increment used by dragging and the arrow keys.
    value / defaultValue / v-model / bind:valuenumberminCurrent value. Blade and Astro use value, React value or defaultValue, Vue v-model or defaultValue, Svelte bind:value, Angular value or [(value)].
    onValueChange(value: number) => void-React only. Called with the new number on every input.
    valueChangeoutput<number>-Angular only. Emits the new number on every input.
    showValuebooleantrueShows the current value on the right of the label with tabular numbers.
    disabledbooleanfalseDisables the slider and dims the label.
    idstringautoInput id. Generated when empty.

    Accessibility

    • A native input type range, so screen readers announce the role slider and the current value.
    • Arrow keys, Page Up, Page Down, Home, and End change the value natively.
    • The visible value is aria-hidden because the slider already announces it.

    Related components

    More form components with the same classes in every framework.