14.5. Ein jQuery UI-Plugin mit eigenen Optionen initialisieren
Problem
Sie wollen ein jQuery UI-Plugin nutzen, aber andere Optionen verwenden, als die vom Plugin-Autor vorgegebenen Standardwerte.
Lösung
Geben Sie eigene Optionen in einem Options-Hash
als erstes Argument der Plugin-Methode init
an:
$('#myDiv').dialog({ height: 100, // überschreibt Standardwert: 'auto' width: 350 // überschreibt Standardwert: 300 });
Diskussion
Alle Options-Werte, die Sie bei init
angeben, überschreiben die Standardwerte. Für
alle nicht angegebenen Options-Werte werden die Standardwerte
verwendet.
Der Options-Hash – egal ob nur aus
Standard-Optionen bestehend oder mit ein paar eigenen Optionen
versehen – ist die Grundlage für den initialen Status des Plugins.
Dieser Status ist spezifisch für die Kombination aus DOMElement
und jQuery UI-Plugin. So können Sie zum
Beispiel ein einzelnes Element mit zwei unterschiedlichen jQuery
UI-Plugins initialisieren, die beide eine Color-Option
besitzen:
$('#myDiv').foo({ color: 'black' }); $('#myDiv').bar({ color: 'green' });
Was ist jetzt die foo
-Farbe für #myDiv
?
Schwarz. Und für bar
? Grün. Beide sind
unabhängig von den CSS-Farben. Wir werden uns in einigen Rezepten
in diesem Kapitel darum kümmern, wie man Elemente nach ihren
Plugin-Werten befragen oder neue Werte zuweisen kann.
Genauso wichtig ist, dass #myDiv
jetzt als foo
und als bar
initialisiert ist und
nicht länger durch diese Plugin-Standardwerte beeinflusst wird. Die
Standardwerte werden nur für init
als
Vorlage für den initialen Status des Plugins genutzt.