Opus Range – Schieberegler für Werte und Bereiche

Opus Range ist ein Schieberegler für jede Website – für einen Wert oder einen Bereich von–bis, etwa Preis, Alter oder Größe. Eine einzige JavaScript-Datei, keine Abhängigkeiten, der Stil ist schon enthalten; auf Wunsch auch als jQuery-Plugin. Kostenlos unter der MIT-Lizenz.

Live-Demo

Wert –

Konfigurieren
Dein Einbindungs-Code

Download

Version 1.0.0 · ca. 22 KB, komprimiert übertragen etwa 7 KB · MIT-Lizenz. Das ZIP enthält die lesbare und die minifizierte Fassung, eine Demo-Seite, README und Lizenz.

Einbinden

Am einfachsten ersetzt Opus Range ein normales <input type="range"> – Minimum, Maximum, Schrittweite und Wert werden direkt aus dem Feld übernommen, und das Feld wird weiter mit dem Formular gesendet. Am besten lädst du die Datei herunter und legst sie auf deinen eigenen Server.

<input type="range" class="regler" name="rabatt" min="0" max="50" step="5" value="20">

<script src="opus-range.min.js"></script>
<script>
OpusRange.init( { selector: '.regler', suffix: ' %' } );
</script>

Für einen Bereich genügt ein Textfeld – der Wert steht darin als von;bis:

<input type="text" name="preis" value="200;800">
<script>
OpusRange.init( {
selector: '[name=preis]',
range: true, min: 0, max: 1000, step: 10,
suffix: ' €', ticks: 4, tooltip: 'always',
} );
</script>

Oder ganz ohne eigenen Code über Attribute:

<input type="text" data-ors data-ors-values="XS;S;M;L;XL" value="M">
<script>OpusRange.init();</script>

Titel mit Platzhaltern

Über dem Regler steht standardmäßig der aktuelle Wert. Mit title wird daraus ein eigener Text – die Platzhalter werden beim Ziehen live ersetzt:

OpusRange.init( { selector: '.preis', range: true, suffix: ' €', title: 'Preis: {value}' } );
// → „Preis: 200 € – 800 €“
PlatzhalterInhalt
{value}aktueller Wert, bei range „von – bis“
{from} / {to}einzelne Werte bei range
{min} / {max}Anfang und Ende der Skala

Die eingesetzten Werte stehen in <span class="ors-val ors-val--value"> (bzw. --from, --to, --min, --max) und lassen sich per CSS gestalten – standardmäßig in der Akzentfarbe. Der Text selbst wird bewusst nicht als HTML gelesen; das ist sicher, auch wenn er aus Daten oder Attributen kommt. Wer HTML braucht, gibt eine Funktion an:

title: function ( value, parts ) {
return 'Lautstärke <strong>' + parts.value + '</strong>';
}

title: false blendet den Titel aus; slider.setTitle( … ) ändert ihn nachträglich.

Mit Eingabefeldern verknüpfen

Regler und Zahlenfelder halten sich gegenseitig auf dem gleichen Stand – wer lieber tippt, tippt:

<input type="number" id="von"> bis <input type="number" id="bis">
<div id="alter"></div>
<script>
new OpusRange( '#alter', { range: true, min: 18, max: 99, value: [ 25, 45 ], inputs: [ '#von', '#bis' ], minDistance: 5 } );
</script>

Optionen

OptionStandardBedeutung
selectornullCSS-Selektor oder Element(e) für init() (sonst [data-ors])
min / max / step0 / 100 / 1Bereich und Schrittweite – bei <input type="range"> direkt aus dem Feld
valuenullStartwert, bei range [von, bis]; sonst aus dem Feld
rangefalseZwei Griffe (von–bis)
valuesnullFeste Werte statt Zahlen, z. B. ['XS', 'S', 'M', 'L', 'XL']
minDistance0Mindestabstand zwischen den Griffen
orientation'horizontal''horizontal' oder 'vertical'
height200Höhe in Pixeln bei vertical
title'{value}'Titel über dem Regler mit Platzhaltern, eigene Funktion für HTML oder false
tooltip'auto'Wert-Blase: 'auto' (beim Ziehen/Fokus), 'always', false
ticksfalseSkala: Anzahl der Abschnitte, true (4) oder Liste von Werten
labelstrueSkala beschriften
filltrueStrecke bis zum Griff bzw. zwischen den Griffen einfärben
decimalsnullNachkommastellen der Anzeige (null = aus step)
prefix / suffix'' / ''Text vor/nach dem Wert, z. B. ' €'
thousands / decimal'.' / ','Tausender- und Dezimalzeichen
formatnullEigene Anzeige: function (value) { return … }
separator';'Trennzeichen im Feld bei range ("200;800")
inputsnullVerknüpfte Felder: Selektor bzw. ['#von', '#bis'] – in beide Richtungen
disabledfalseGesperrt
theme'light''light', 'dark', 'auto'
lang / strings'auto' / nullSprache der Bildschirmleser-Texte (de/en) bzw. eigene Texte
className''Zusätzliche CSS-Klasse
onInputnullfunction (value, slider) beim Ziehen
onChangenullfunction (value, slider) nach dem Loslassen bzw. bei Tastatur

Der Wert ist eine Zahl, bei range ein Array [von, bis] und bei values der jeweilige Text.

Methoden und Ereignisse

const slider = new OpusRange( '#feld', { range: true, max: 500 } );

slider.setValue( [ 100, 300 ] );
slider.getValue(); // [100, 300]
slider.format( 1250 ); // '1.250'
slider.disable(); slider.enable();
slider.on( 'change', ( value ) => console.log( value ) );
slider.destroy();

OpusRange.get( '#feld' ); // Regler zu einem Element
OpusRange.defaults.theme = 'auto'; // Voreinstellung für alle

Ereignisse: input (beim Ziehen) und change (nach dem Loslassen). Am Feld und an verknüpften Feldern werden zusätzlich die normalen input– und change-Ereignisse ausgelöst.

Mit jQuery

Das Skript braucht kein jQuery. Ist jQuery auf deiner Seite geladen, steht es zusätzlich als jQuery-Plugin bereit:

jQuery( function ( $ ) {
$( '.regler' ).opusRange( { range: true, suffix: ' €' } );

$( '#feld' ).opusRange( 'setValue', [ 100, 300 ] ); // Methoden aufrufen (verkettbar)
$( '#feld' ).opusRange( 'getValue' ); // Wert des ersten Elements
$( '#feld' ).on( 'change', function () { console.log( $( this ).val() ); } );
} );

Aussehen anpassen

.ors {
--ors-accent: #0a7cff; /* Akzentfarbe */
--ors-size: 22px; /* Griffgröße */
--ors-height: 4px; /* Spurstärke */
}

Weitere Variablen: --ors-track, --ors-handle, --ors-text, --ors-muted, --ors-tip-bg, --ors-tip-text. Mit theme: 'dark' oder 'auto' gibt es eine dunkle Variante.

Bedienung und Browser

  • Maus und Touch: Griff ziehen oder auf die Spur bzw. eine Skalen-Beschriftung tippen – der nächste Griff springt hin.
  • Tastatur: Pfeiltasten ein Schritt, Bild auf/ab 10 %, Pos1/Ende an Anfang/Ende.
  • Die Griffe kreuzen sich nicht und halten den Mindestabstand ein.
  • Beschriftet für Screenreader (Rolle „slider“, aktueller Wert als Text), deutsch oder englisch.
  • Aktuelle Versionen von Chrome, Edge, Firefox und Safari, auch auf dem Smartphone.

Lizenz

Opus Range steht unter der MIT-Lizenz: Du darfst es kostenlos nutzen, verändern und weitergeben – auch in kommerziellen Projekten. Einzige Bedingung: Der Copyright- und Lizenzhinweis (der Kommentar am Anfang der Datei) bleibt erhalten. Die Software wird ohne Gewährleistung bereitgestellt.

Versionen

  • 1.0.0 · 22.11.2026 · Erste Veröffentlichung