jQuery UI Wie es funktioniert

jQuery UI enthält viele zustandsbehaftete Widgets (Widget), daher unterscheidet es sich geringfügig vom typischen Nutzungsmuster von jQuery-Plugins. Seine Installation ähnelt der der meisten jQuery-Plugins. jQuery-UI-Widgets basieren aufWidget Factoryerstellt, und die Widget Factory bietet eine gemeinsame API. Wenn Sie also einmal gelernt haben, eines davon zu verwenden, wissen Sie, wie Sie die anderen Widgets verwenden. In diesem Tutorial werdenprogressbarWidget-Codebeispiele verwendet, um gemeinsame Funktionen vorzustellen.

Installation

Um den Zustand des Widgets nachzuverfolgen, führen wir zunächst den vollständigen Lebenszyklus eines Widgets ein. Der Lebenszyklus beginnt, wenn das Widget installiert wird. Wir müssen das Plugin nur auf einem oder mehreren Elementen aufrufen, um das Widget zu installieren.

$( "#elem" ).progressbar();

Dies initialisiert jedes Element im jQuery-Objekt. In diesem Beispiel ist die Element-ID "elem". Da wir die parameterlose.progressbar()Methode aufrufen, wird das Widget gemäß seinen Standardoptionen initialisiert. Wir können bei der Installation eine Reihe von Optionen übergeben, um die Standardoptionen zu überschreiben.

$( "#elem" ).progressbar({ value: 20 });

Die Anzahl der während der Installation übergebenen Optionen kann durch unsere Anforderungen bestimmt werden. Alle Optionen, die wir nicht übergeben, verwenden ihre Standardwerte.

Optionen sind Teil des Zustands des Widgets, daher können wir Optionen auch nach der Installation festlegen. Wir werden dies imoptionAbschnitt „Methoden“ vorstellen.

Methoden

Nachdem das Widget initialisiert ist, können wir seinen Zustand abfragen oder Aktionen darauf ausführen. Alle Aktionen nach der Initialisierung erfolgen in Form von Methodenaufrufen. Um eine Methode für ein Widget aufzurufen, können wir den Methodennamen an das jQuery-Plugin übergeben. Um beispielsweise die Methode des progressbar-Widgetsvalueaufzurufen, sollten wir Folgendes verwenden:

$( "#elem" ).progressbar( "value" );

Wenn die Methode Parameter akzeptiert, können wir Parameter nach dem Methodennamen übergeben. Um beispielsweise Parameter für die40GibvalueMethode zu übergeben, können wir Folgendes verwenden:

$( "#elem" ).progressbar( "value", 40 );

Wie andere Methoden in jQuery geben die meisten Widget-Methoden jQuery-Objekte zur Verkettung zurück.

$( "#elem" )
    .progressbar( "value", 90 )
    .addClass( "almost-done" );

Öffentliche Methoden

Jedes Widget hat seinen eigenen Satz von Methoden, basierend auf der Funktionalität, die das Widget bereitstellt. Einige Methoden sind jedoch allen Widgets gemeinsam.

option

Wie bereits erwähnt, können wir Optionen nach der Initialisierung über dieoptionMethode. Zum Beispiel können wir dieoptionMethode, um den Wert von progressbar auf 30 zu ändern.

$( "#elem" ).progressbar( "option", "value", 30 );

Beachte, dass sich dies von der vorherigen Instanz unterscheidet, in der wir dievalueMethode. In diesem Fall rufen wir dieoptionMethode, die die Option value auf 30 ändert.

Wir können auch den aktuellen Wert einer Option abrufen.

$( "#elem" ).progressbar( "option", "value" );

Darüber hinaus können wir an dieoptionMethode ein Objekt übergeben, um mehrere Optionen auf einmal zu aktualisieren.

$( "#elem" ).progressbar( "option", {
    value: 100,
    disabled: true
});

Vielleicht ist dir aufgefallen, dass dieoptionMethode dieselbe Signatur hat wie Getter und Setter im jQuery-Code, genau wie.css()und.attr(). Der einzige Unterschied besteht darin, dass Sie die Zeichenfolge "option" als ersten Parameter übergeben müssen.

disable

disableMethode deaktiviert das Widget. In der progressbar-Instanz ändert dies den Stil, um die Fortschrittsleiste als deaktiviert anzuzeigen.

$( "#elem" ).progressbar( "disable" );

AufrufendisableMethode entspricht dem Setzen vondisabledOption auftrue。

enable

enableDie Methode istdisabledas Gegenteil der Methode.

$( "#elem" ).progressbar( "enable" );

AufrufenenableMethode entspricht dem Setzen vondisabledOption auffalse。

destroy

Wenn Sie das Widget nicht mehr benötigen, können Sie es zerstören und zum ursprünglichen Markup zurückkehren. Dies bedeutet das Ende des Lebenszyklus des Widgets.

$( "#elem" ).progressbar( "destroy" );

Sobald Sie ein Widget zerstört haben, können Sie keine Methoden mehr darauf aufrufen, es sei denn, Sie dieses Widget neu initialisieren. Wenn Sie das Element entfernen möchten, können Sie direkt verwenden.remove(), oder Sie können verwenden.html()oder.empty()um dies zu erreichen, und das Widget wird automatisch zerstört.

widget

Einige Widgets erzeugen Wrapper-Elemente oder Elemente, die vom ursprünglichen Element getrennt sind. Im folgenden Beispiel,widgetgibt das generierte Element zurück. In der progressbar-Instanz gibt es keinen generierten Wrapper,widgetMethode gibt das ursprüngliche Element zurück.

$( "#elem" ).progressbar( "widget" );

Ereignisse

Alle Widgets haben Ereignisse, die mit ihren verschiedenen Verhaltensweisen zusammenhängen und dazu dienen, Sie zu benachrichtigen, wenn sich der Zustand ändert. Bei den meisten Widgets wird dem Namen beim Auslösen eines Ereignisses der Widget-Name vorangestellt. Zum Beispiel können wir das change-Ereignis der progressbar binden, das ausgelöst wird, sobald sich der Wert ändert.

$( "#elem" ).bind( "progressbarchange", function() {
    alert( "The value has changed!" );
});

Jedes Ereignis hat einen entsprechenden Callback, der als Option angegeben wird. Wir können den Callback der progressbar verwenden,changeCallback, der dem Binden des entsprichtprogressbarchangeEreignis.

$( "#elem" ).progressbar({
    change: function() {
        alert( "The value has changed!" );
    }
});

Öffentliche Ereignisse

Die meisten Ereignisse sind spezifisch für bestimmte Widgets; alle Widgets haben ein gemeinsamescreateEreignis. Dieses Ereignis wird ausgelöst, wenn das Widget erstellt wird.

Andere Erweiterungen