jQuery.when()Méthode

jQuery 杂项方法Méthodes diverses jQuery

Exemple

Un paramètre passé à $.when() est résolu, et la fonction de rappel est exécutée.

$(function () { $.when( { testing: 123 } ).done( function(x) { alert(x.testing); } /* alerts "123" */ ); })

Essayez-le vous-même »

Définition et utilisation

La fonction $.when() permet d'exécuter des fonctions de rappel pour un ou plusieurs objets.

Astuce :Si un objet différé est passé à jQuery.when, son objet Promise (un sous-ensemble des méthodes différées) est renvoyé. Vous pouvez continuer à lier d'autres méthodes de l'objet Promise, telles que defered.then. Lorsque l'objet différé a été résolu ou rejeté (généralement effectué par le code initial qui a créé l'objet différé), les fonctions de rappel correspondantes seront appelées.


Syntaxe

$.when( deferreds )

Paramètre Description
deferreds Type Deferred : un ou plusieurs objets différés, ou des objets JavaScript ordinaires.


实例

Plus d’exemples


Si vous ne passez aucun paramètre, jQuery.when() renverra un objet Promise dans l'état résolu.

Exemple

Exécuter la fonction de rappel sans passer aucun paramètre

[mycode3 type="javascript"] $(function () { $.when().then(function( x ) { alert( "I fired immediately" ); }); }) [/mycode3]

Essayez-le vous-même »

Dans le cas où plusieurs objets différés sont passés à jQuery.when(), cette méthode renvoie un nouvel objet différé « hôte ». Il résout son objet différé hôte uniquement lorsque tous les objets différés sont résolus. Lorsque l'un des objets différés est rejeté, il rejette son objet différé hôte. Lorsque l'objet hôte est résolu, les doneCallbacks (fonctions de rappel de résolution) seront exécutés.

Exemple

Passer plusieurs objets différés

[mycode3 type="javascript"] $(function () { var d1 = $.Deferred(); var d2 = $.Deferred(); $.when( d1, d2 ).done(function ( v1, v2 ) { alert( v1 ); // "Fish" alert( v2 ); // "Pizza" }); d1.resolve( "Fish" ); d2.resolve( "Pizza" ); }) [/mycode3]

Essayez-le vous-même »

Si aucune valeur n'est passée à l'événement résolu d'un objet différé, le paramètre doneCallback correspondant sera undefined. Si une seule valeur est passée à l'événement résolu d'un objet différé, le paramètre correspondant conservera cette valeur. Dans le cas où plusieurs valeurs sont passées à l'événement résolu d'un objet différé, le paramètre correspondant sera un tableau de ces valeurs.

Exemple

Passer plusieurs objets différés de types différents

[mycode3 type="javascript"] $(function () { var d1 = $.Deferred(); var d2 = $.Deferred(); var d3 = $.Deferred(); $.when( d1, d2, d3 ).done(function ( v1, v2, v3 ) { alert( v1 ); // v1 is undefined alert( v2 ); // v2 is "abc" alert( v3 ); // v3 is an array [ 1, 2, 3, 4, 5 ] }); d1.resolve(); d2.resolve( "abc" ); d3.resolve( 1, 2, 3, 4, 5 ); }) [/mycode3]

Essayez-le vous-même »

Dans le cas de plusieurs objets différés, si l'un des objets différés est rejeté, jQuery.when() déclenche immédiatement la fonction de rappel failCallbacks de l'objet différé "hôte".

Exemple

Appelez la fonction de rappel failCallbacks lorsque l'un de plusieurs objets différés est rejeté

[mycode3 type="javascript"] $(function () { $.when($.ajax("/page1.php"), $.ajax("/page2.php")).then(function(data, textStatus, jqXHR){ alert(jqXHR.status); }, function(obj){ alert(obj.statusText); }); }) [/mycode3]

Essayez-le vous-même »


jQuery 杂项方法Méthodes diverses jQuery

Autres extensions