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.
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
| Option | Standard | Bedeutung |
|---|---|---|
selector | null | CSS-Selektor oder Element(e) für init() (sonst [data-ocp]) |
color | null | Startfarbe, 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 |
alpha | true | Transparenz erlauben |
inline | false | Dauerhaft sichtbar statt aufklappend |
container | null | Ziel-Element für inline |
swatch | true | Farbvorschau im Eingabefeld |
swatches | null | Liste von Farbfeldern, z. B. ['#ff6c36', 'transparent'] |
input | true | Textfeld für den Farbwert im Picker |
buttons | false | „Abbrechen“ und „Übernehmen“ statt sofort übernehmen |
clearable | false | Knopf „Leeren“ |
eyedropper | true | Pipette (nur wenn der Browser sie unterstützt) |
position | 'auto' | 'auto', 'bottom', 'top' |
align | 'left' | 'left', 'right' |
theme | 'light' | 'light', 'dark', 'auto' (folgt dem System) |
width | 240 | Breite in Pixeln |
closeOnSwatch | false | Nach Klick auf ein Farbfeld schließen |
lang | 'auto' | 'auto', 'de', 'en' |
strings | null | Eigene Texte, z. B. { save: 'OK' } |
zIndex | 9999 | Ebene des Fensters |
className | '' | Zusätzliche CSS-Klasse für das Fenster |
onInput | null | function (color, picker) bei jeder Änderung, auch beim Ziehen |
onChange | null | function (color, picker) beim Übernehmen – null beim Leeren |
onOpen / onClose | null | Beim Ö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
