jQuery one()

admin發表於2017-02-18
jQuery

此方法為匹配元素的特定事件繫結一個一次性的事件處理方法。

one()繫結事件處理函式利用事件冒泡，匹配元素上註冊的事件處理函式會響應子元素的事件觸發。

語法結構一:

[JavaScript] 純文字檢視 複製程式碼
.one(events [, data ], handler(eventObject))

引數解析:

（1）.events:一個或多個空格分隔的事件型別和可選的名稱空間，或僅僅是名稱空間，比如"click", "keydown.myPlugin", 或者 ".myPlugin"。

（2）.data:當一個事件被觸發時，要傳遞給event.data的資料。

（3）.handler(eventObject):事件處理函式，引數是事件物件。

jQuery1.1版本新增。

語法結構二:

[JavaScript] 純文字檢視 複製程式碼
.one(events [, selector ] [, data ], handler(eventObject))

引數解析:

（1）.events:一個或多個空格分隔的事件型別和可選的名稱空間，或僅僅是名稱空間，比如"click", "keydown.myPlugin", 或者 ".myPlugin"。

（2）.selector:可選，一個選擇器字串，用於過濾出匹配元素中能觸發事件的後代元素。

（3）.data:當一個事件被觸發時，要傳遞給event.data的資料。

（4）.handler(eventObject):事件處理函式，引數是事件物件。

jQuery1.7版本新增。

[JavaScript] 純文字檢視 複製程式碼
.one(events [, selector ] [, data ])

引數解析:

（1）.events:一個物件，鍵是由一個或多個由空格分隔的事件型別及可選的名稱空間，值是這些事件型別所對應的事件處理函式。

（2）.selector:可選，一個選擇器字串，用於過濾出匹配元素中能觸發事件的後代元素。

（3）.data:當一個事件被觸發時，要傳遞給event.data的資料。

jQuery1.7版本新增。

關於名稱空間可以參閱jQuery 名稱空間一章節。

程式碼例項:

[HTML] 純文字檢視 複製程式碼執行程式碼
<!DOCTYPE html>
<html>
<head>
<meta charset=" utf-8">
<meta name="author" content="http://www.softwhy.com/" />
<title>螞蟻部落</title>
<style type="text/css">
#box{
  width:200px;
  height:150px;
  background:#ccc;
  text-align:center;
  color:red;
}
#ant{
  width:150px;
  height:100px;
  background:green;
}
</style>
<script src="https://code.jquery.com/jquery-3.0.0.js"></script>
<script type="text/javascript"> 
$(document).ready(function () {
  var count = 0;
  $("#box").one("click", function () {
    count = count + 1;
    $("#box").text(count);
  })
})
</script> 
</head> 
<body>
<div id="box">
  <div id="ant">
    <input type="button" value="檢視效果"/>
  </div>
</div>
</body>
</html>

註冊的事件處理函式只會被執行一次。

語法結構與on()是完全相同的，具體可以參閱jQuery on()一章節。

相關文章