Opus Color – Farbwähler mit Transparenz

Opus Color ist ein schlanker Farbwähler für jede Website – eine einzige JavaScript-Datei, keine Abhängigkeiten, der Stil ist schon enthalten. Mit Transparenz, HEX/RGB/HSL, Farbfeldern, Pipette und vielen Einstellungen – auf Wunsch auch als jQuery-Plugin. Kostenlos unter der MIT-Lizenz.

Live-Demo
Konfigurieren
Dein Einbindungs-Code

Download

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

Einbinden

Skript laden und für deine Eingabefelder starten – fertig. Am besten lädst du die Datei herunter und legst sie auf deinen eigenen Server; so werden keine Daten deiner Besucher an Dritte übertragen.

<input type="text" class="farbe" value="#ff6c36">

<script src="opus-color.min.js"></script>
<script>
OpusColor.init( {
selector: '.farbe',
swatches: [ '#ff6c36', '#1d1d1b', 'transparent' ],
} );
</script>

Ganz ohne eigenen Code geht es auch: Felder mit data-ocp bekommen mit OpusColor.init() einen Picker, Optionen stehen direkt am Feld:

<input data-ocp data-ocp-format="rgb" data-ocp-alpha="false" data-ocp-swatches="#f00;#0f0;#00f">
<script>OpusColor.init();</script>

Optionen

OptionStandardBedeutung
selectornullCSS-Selektor oder Element(e) für init() (sonst [data-ocp])
colornullStartfarbe, wenn das Feld leer ist
format'auto'Ausgabe: 'auto' (wie eingegeben), 'hex', 'rgb', 'hsl'
formats['hex','rgb','hsl']Umschaltbare Formate im Picker; [] blendet den Umschalter aus
alphatrueTransparenz erlauben
inlinefalseDauerhaft sichtbar statt aufklappend
containernullZiel-Element für inline
swatchtrueFarbvorschau im Eingabefeld
swatchesnullListe von Farbfeldern, z. B. ['#ff6c36', 'transparent']
inputtrueTextfeld für den Farbwert im Picker
buttonsfalse„Abbrechen“ und „Übernehmen“ statt sofort übernehmen
clearablefalseKnopf „Leeren“
eyedroppertruePipette (nur wenn der Browser sie unterstützt)
position'auto''auto', 'bottom', 'top'
align'left''left', 'right'
theme'light''light', 'dark', 'auto' (folgt dem System)
width240Breite in Pixeln
closeOnSwatchfalseNach Klick auf ein Farbfeld schließen
lang'auto''auto', 'de', 'en'
stringsnullEigene Texte, z. B. { save: 'OK' }
zIndex9999Ebene des Fensters
className''Zusätzliche CSS-Klasse für das Fenster
onInputnullfunction (color, picker) bei jeder Änderung, auch beim Ziehen
onChangenullfunction (color, picker) beim Übernehmen – null beim Leeren
onOpen / onClosenullBeim Öffnen / Schließen

Das color-Objekt in den Rückrufen enthält hex, rgb, hsl, r, g, b, a, hsv und toString(format).

Methoden und Ereignisse

const picker = new OpusColor( '#feld', { format: 'rgb' } );

picker.setColor( 'rgba(255, 108, 54, .5)' );
picker.getColor( 'hex' ); // '#ff6c3680'
picker.open(); picker.close(); picker.clear();
picker.on( 'change', ( color ) => console.log( color && color.rgb ) );
picker.destroy();

OpusColor.get( '#feld' ); // Picker zu einem Element
OpusColor.parse( 'hsl(16, 100%, 61%)' ); // Farbobjekt oder null
OpusColor.format( '#f60', 'rgb' ); // 'rgb(255, 102, 0)'
OpusColor.defaults.theme = 'auto'; // Voreinstellung für alle

Ereignisse: input, change, open, close, clear. Am Eingabefeld werden zusätzlich die normalen input– und change-Ereignisse ausgelöst – Formulare und Frameworks bekommen Änderungen also ganz normal mit.

Mit jQuery

Das Skript braucht kein jQuery. Ist jQuery auf deiner Seite aber ohnehin geladen – etwa in älteren Themes, Shops oder Admin-Bereichen –, meldet es sich zusätzlich als jQuery-Plugin an:

jQuery( function ( $ ) {
$( '.farbe' ).opusColor( { swatches: [ '#ff6c36', 'transparent' ] } );

$( '#feld' ).opusColor( 'setColor', '#ff6c36' ); // Methoden aufrufen (verkettbar)
$( '#feld' ).opusColor( 'getColor', 'hex' ); // Wert des ersten Elements
$( '#feld' ).opusColor( 'instance' ); // das Picker-Objekt
$( '#feld' ).opusColor( 'destroy' );

$( '#feld' ).on( 'change', function () { console.log( $( this ).val() ); } );
} );

Vorhandener jQuery-Code mit .on( 'change' ) funktioniert unverändert, weil der Picker die normalen Ereignisse auslöst. Wird jQuery erst nach dem Skript geladen, meldet es sich beim fertigen Dokument an – oder von Hand mit OpusColor.registerJQuery( jQuery ).

Aussehen anpassen

.ocp {
--ocp-accent: #0a7cff; /* Akzentfarbe */
--ocp-radius: 6px; /* Ecken */
}

Weitere Variablen: --ocp-bg, --ocp-text, --ocp-muted, --ocp-border, --ocp-field, --ocp-check. Mit theme: 'dark' oder 'auto' gibt es eine dunkle Variante.

Bedienung und Browser

  • Maus, Touch und Tastatur: Pfeiltasten verschieben Fläche und Regler, mit Umschalt in größeren Schritten; Esc schließt.
  • Beschriftungen für Screenreader, deutsch oder englisch.
  • Aktuelle Versionen von Chrome, Edge, Firefox und Safari, auch auf dem Smartphone.

Lizenz

Opus Color steht unter der MIT-Lizenz: Du darfst ihn 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