當前位置: 首頁>>代碼示例 >>用法及示例精選 >>正文

JQuery .promise()用法及代碼示例


用法 
.promise(  [type ] [, target ] ) => Promise

說明：返回一個 Promise 對象以觀察綁定到集合的特定類型的所有操作(無論是否排隊)都已完成。

  • 添加的版本：1.6.promise( [type ] [, target ] )

    • type(默認：fx)
      類型：String
      需要觀察的隊列類型。
    • target
      類型：PlainObject
      必須附加承諾方法的對象

.promise() 方法返回一個動態生成的 Promise，一旦綁定到集合的特定類型的所有操作(無論是否排隊)都結束，該 Promise 就會被解析。

默認情況下，type 是 "fx" ，這意味著當所選元素的所有動畫都完成時，返回的 Promise 被解析。

解析上下文和唯一參數是調用.promise() 的集合。

如果提供了target，.promise() 會將方法附加到它上麵，然後返回這個對象而不是創建一個新對象。這對於將 Promise 行為附加到已經存在的對象很有用。

注意：返回的 Promise 鏈接到存儲在.data()對於一個元素。由於.remove()方法會刪除元素的數據以及元素本身，它會阻止元素的任何未解析的 Promise 解析。如果有必要在解析 Promise 之前從 DOM 中刪除元素，請使用.detach()而是跟隨.removeData()解決後。

例子：

在沒有活動動畫的集合上使用 .promise() 會返回已解決的 Promise：

var div = $( "<div>" );
 
div.promise().done(function( arg1 ) {
  // Will fire right away and alert "true"
  alert( this === div && arg1 === div );
});

當所有動畫結束時解析返回的 Promise(包括那些在動畫回調中啟動或稍後添加的動畫)：

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>promise demo</title>
  <style>
  div {
    height: 50px;
    width: 50px;
    float: left;
    margin-right: 10px;
    display: none;
    background-color: #090;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.5.0.js"></script>
</head>
<body>
 
<button>Go</button>
<p>Ready...</p>
<div></div>
<div></div>
<div></div>
<div></div>
 
<script>
$( "button" ).on( "click", function() {
  $( "p" ).append( "Started..." );
 
  $( "div" ).each(function( i ) {
    $( this ).fadeIn().fadeOut( 1000 * ( i + 1 ) );
  });
 
  $( "div" ).promise().done(function() {
    $( "p" ).append( " Finished! " );
  });
});
</script>
 
</body>
</html>

演示：

使用 $.when() 語句解析返回的 Promise(.promise() 方法可以使用 jQuery 集合執行此操作)：

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>promise demo</title>
  <style>
  div {
    height: 50px;
    width: 50px;
    float: left;
    margin-right: 10px;
    display: none;
    background-color: #090;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.5.0.js"></script>
</head>
<body>
 
<button>Go</button>
<p>Ready...</p>
<div></div>
<div></div>
<div></div>
<div></div>
 
<script>
var effect = function() {
  return $( "div" ).fadeIn( 800 ).delay( 1200 ).fadeOut();
};
 
$( "button" ).on( "click", function() {
  $( "p" ).append( " Started... " );
 
  $.when( effect() ).done(function() {
    $( "p" ).append( " Finished! " );
  });
});
</script>
 
</body>
</html>

演示：

相關用法


注：本文由純淨天空篩選整理自jquery.com大神的英文原創作品 .promise()。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。