首頁  >  事件  > trigger(type,[data])

返回值:jQuery trigger(type,[data])

概述

在每一個匹配的元素上觸發某類事件。

這個函式也會導致瀏覽器同名的預設行為的執行。比如,如果用trigger()觸發一個'submit',則同樣會導致瀏覽器提交表單。如果要阻止這種預設行為,應返回false。

你也可以觸發由bind()註冊的自定義事件而不限於瀏覽器預設事件。

事件處理函式會收到一個修復的(規範化的)事件對象,但這個對像沒有特定瀏覽器才有的屬性,比如keyCode。

jQuery也支援 <a href="//docs.jquery.com/Namespaced_Events">名稱空間事件</a>。這允許你觸發或者解除繫結一組特定的事件處理函式,而無需一一個指定。你可以在事件型別後面加上感嘆號 ! 來只觸發那些沒有名稱空間的事件處理函式。

jQuery 1.3中新增:

所有觸發的事件現在會冒泡到DOM樹上了。舉例來說,如果你在一個段落p上觸發一個事件,他首先會在這個元素上觸發,其次到父元素,在到父元素的父元素,直到觸發到document對象。這個事件對像有一個 .target 屬性指向最開始觸發這個事件的元素。你可以用 stopPropagation() 來阻止事件冒泡,或者在事件處理函式中返回false即可。

事件對像構造器現在已經公開,並且你可以自行建立一個事件對象。這個事件對象可以直接傳遞給trigger所觸發的事件處理函式。事件對象的完整屬性列表可以在 <a href="//docs.jquery.com/Events/jQuery.Event">jQuery.Event</a> 的文件里找到。

你可以有三種方式指定事件型別:

* 你可以傳遞字串型的事件名稱(type參數)。

* 你可以使用jQuery.Event對象。可以將資料放進這個對象,並且這個對象可以被觸發的事件處理函式獲取到。

* 最後,你可以傳遞一個帶有資料的字面量對象。他將被複制到真正的jQuery.Event對像上去。 注意在這種情況下你'''必須'''指定一個 <em>type</em> 屬性。

參數

type,[data] String|Event,Array V1.0

type: 一個事件對像或者要觸發的事件型別

data: 傳遞給事件處理函式的附加參數

event Object V1.3

事件發生時執行的函式

示例

描述:

提交第一個表單,但不用submit()

jQuery 程式碼:

$("form:first").trigger("submit")

描述:

給一個事件傳遞參數

jQuery 程式碼:

$("p").click( function (event, a, b) {
  // 一個普通的點選事件時,a和b是undefined型別
  // 如果用下面的語句觸發,那麼a指向"foo",而b指向"bar"
} ).trigger("click", ["foo", "bar"]);

描述:

下面的程式碼可以顯示一個"Hello World"

jQuery 程式碼:

$("p").bind("myEvent", function (event, message1, message2) {
  alert(message1 + ' ' + message2);
});
$("p").trigger("myEvent", ["Hello","World!"]);