YUI提供的Event工具集
YUI提供的Event工具集簡化了瀏覽器中事件驅(qū)動程序的編寫,提供了一種簡單的接口來定制事件和檢查瀏覽器中的event對象。YUI事件工具集提供了自定義事件對象(Custom Event),通過自定義事件對象可以“發(fā)布”自己感興趣的時刻或事件,頁面中的YUI組件能夠響應(yīng)這些自定義的事件并做出回應(yīng)。
YUI對事件響應(yīng)的順序:通過YUI Event工具集添加的事件,默認是在冒泡過程中執(zhí)行事件處理函數(shù)的。從DOM節(jié)點上來說,是從子節(jié)點向根節(jié)點響應(yīng)事件。
<!-- Dependency -->
build/yahoo/yahoo-min.js
<!-- Event source file -->
build/event/event-min.js
Event和Custom Event分別定義在YAHOO.util.Event和YAHOO.util.CustomEvent中
YAHOO.util.Event.addListener(element,eventType,fn,obj,override)
參數(shù):
element:為綁定事件的元素id,可以是一個數(shù)組,以支持批量操作
eventType:為事件類型
fn:為事件響應(yīng)的回調(diào)函數(shù)
obj:當override為true時,為回調(diào)函數(shù)傳入的參數(shù)對象;當override為false時,該參數(shù)被忽略。
override:
返回值類型:Boolean
功能:給指定的element綁定事件響應(yīng)函數(shù)
YAHOO.util.Event.removeListener:function(element,eventType,fn)
參數(shù):
element:為綁定事件的元素id,
eventType:事件類型
fn:為事件響應(yīng)函數(shù)
返回值類型:Boolean
功能:給指定的element解除綁定事件
YAHOO.util.Event.purgeElement ( el , recurse , sType )
參數(shù):
el:為綁定事件的元素id,
recurse:Boolean值,是否解除子節(jié)點的事件綁定
sType:事件類型
返回值類型:Boolean
功能:給指定的element解除綁定的同一類型的事件,也可以解除子節(jié)點上綁定的這一類型的事件
YAHOO.util.on
addListener的函數(shù)別名
YAHOO.util.Event.onAvailable ( p_id , p_fn , p_obj , p_override )
參數(shù):
p_id:為綁定事件的元素id,
p_fn:為事件響應(yīng)函數(shù)
p_obj:同addListener的obj參數(shù)
p_override:同addListener的override參數(shù)
返回值類型:無
功能:當指定的element的p_id出現(xiàn)時,執(zhí)行事件響應(yīng)函數(shù)。如果在頁面初始化之前執(zhí)行這一函數(shù),當頁面加載時(可能還未完成時),就會執(zhí)行響應(yīng)的事件響應(yīng)函數(shù);如果放在頁面加載之后執(zhí)行這一函數(shù),將以固定的時間輪詢,當element可用時響應(yīng)這一事件。這個輪詢的的時間是可以配置的,缺省的時間是10秒一次。
YAHOO.util.Event.onContentReady ( p_id , p_fn , p_obj , p_override )
參數(shù):
p_id:為綁定事件的元素id,
p_fn:為事件響應(yīng)函數(shù)
p_obj:同addListener的obj參數(shù)
p_override:同addListener的override參數(shù)
返回值類型:無
功能:與onAvailable類似,但不同的是事件響應(yīng)函數(shù)是等到element可以安全的修改的時候才響應(yīng)。
YAHOO.util.Event.onDOMReady ( p_fn , p_obj , p_scope )
參數(shù):
p_fn:為事件響應(yīng)函數(shù)
p_obj:同addListener的obj參數(shù)
p_scope:同addListener的override參數(shù)
返回值類型:無
功能:當DOM第一次可用時執(zhí)行響應(yīng)函數(shù)。
YAHOO.util.Event.preventDefault ( event)
參數(shù):
event:事件對象
返回值類型:無
功能:阻止事件的缺省行為發(fā)生。