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.
Wert –
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 €“
| Platzhalter | Inhalt |
|---|---|
{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
| Option | Standard | Bedeutung |
|---|---|---|
selector | null | CSS-Selektor oder Element(e) für init() (sonst [data-ors]) |
min / max / step | 0 / 100 / 1 | Bereich und Schrittweite – bei <input type="range"> direkt aus dem Feld |
value | null | Startwert, bei range [von, bis]; sonst aus dem Feld |
range | false | Zwei Griffe (von–bis) |
values | null | Feste Werte statt Zahlen, z. B. ['XS', 'S', 'M', 'L', 'XL'] |
minDistance | 0 | Mindestabstand zwischen den Griffen |
orientation | 'horizontal' | 'horizontal' oder 'vertical' |
height | 200 | Hö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 |
ticks | false | Skala: Anzahl der Abschnitte, true (4) oder Liste von Werten |
labels | true | Skala beschriften |
fill | true | Strecke bis zum Griff bzw. zwischen den Griffen einfärben |
decimals | null | Nachkommastellen der Anzeige (null = aus step) |
prefix / suffix | '' / '' | Text vor/nach dem Wert, z. B. ' €' |
thousands / decimal | '.' / ',' | Tausender- und Dezimalzeichen |
format | null | Eigene Anzeige: function (value) { return … } |
separator | ';' | Trennzeichen im Feld bei range ("200;800") |
inputs | null | Verknüpfte Felder: Selektor bzw. ['#von', '#bis'] – in beide Richtungen |
disabled | false | Gesperrt |
theme | 'light' | 'light', 'dark', 'auto' |
lang / strings | 'auto' / null | Sprache der Bildschirmleser-Texte (de/en) bzw. eigene Texte |
className | '' | Zusätzliche CSS-Klasse |
onInput | null | function (value, slider) beim Ziehen |
onChange | null | function (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
