事件处理

$.Event

$.Event(type, [properties])   => event

创建并初始化一个指定的DOM事件。如果给定properties对象,使用它来扩展出新的事件对象。默认情况下,事件被设置为冒泡方式;这个可以通过设置bubblesfalse来关闭。

一个事件初始化的函数可以使用 trigger来触发。

$.Event('mylib:change', { bubbles: false })

$.proxy v1.0+

$.proxy(fn, context)   => function
$.proxy(fn, context, [additionalArguments...])   => function v1.1.4+
$.proxy(context, property)   => function
$.proxy(context, property, [additionalArguments...])   => function v1.1.4+

接受一个函数,然后返回一个新函数,并且这个新函数始终保持了特定的上下文(context)语境,新函数中this指向context参数。另外一种形式,原始的function是从上下文(context)对象的特定属性读取。

如果传递超过2个的额外参数,它们被用于 传递给fn参数的函数 引用。

var obj = {name: 'Zepto'},
    handler = function(){ console.log("hello from + ", this.name) }

// ensures that the handler will be executed in the context of `obj`:
$(document).on('click', $.proxy(handler, obj))

bind

不推荐, 使用 on 代替。

bind(type, function(e){ ... })   => self
bind(type, [data], function(e){ ... })   => self v1.1+
bind({ type: handler, type2: handler2, ... })   => self
bind({ type: handler, type2: handler2, ... }, [data])   => self v1.1+

为一个元素绑定一个处理事件。

delegate

不推荐, 使用 on 代替。

delegate(selector, type, function(e){ ... })   => self
delegate(selector, { type: handler, type2: handler2, ... })   => self

基于一组特定的根元素为所有选择器匹配的元素附加一个处理事件,匹配的元素可能现在或将来才创建。

die

不推荐, 使用 on 代替。

die(type, function(e){ ... })   => self
die({ type: handler, type2: handler2, ... })   => self

删除通过 live 添加的事件。

event.isDefaultPrevented v1.1+

event.isDefaultPrevented()   => boolean

如果preventDefault()被该事件的实例调用,那么返回true。 这可作为跨平台的替代原生的 defaultPrevented属性,如果 defaultPrevented缺失或在某些浏览器下不可靠的时候。

// trigger a custom event and check whether it was cancelled
var event = $.Event('custom')
element.trigger(event)
event.isDefaultPrevented()

event.isImmediatePropagationStopped v1.1+

event.isImmediatePropagationStopped()   => boolean

如果stopImmediatePropagation()被该事件的实例调用,那么返回true。Zepto在不支持该原生方法的浏览器中实现它, (例如老版本的Android)。

event.isPropagationStopped v1.1+

event.isPropagationStopped()   => boolean

如果stopPropagation()被该事件的实例调用,那么返回true。

live

不推荐, 使用 on 代替。

live(type, function(e){ ... })   => self
live({ type: handler, type2: handler2, ... })   => self

类似delegate,添加一个个事件处理器到符合目前选择器的所有元素匹配,匹配的元素可能现在或将来才创建。

off

off(type, [selector], function(e){ ... })   => self
off({ type: handler, type2: handler2, ... }, [selector])   => self
off(type, [selector])   => self
off()   => self

移除通过 on 添加的事件.移除一个特定的事件处理程序, 必须通过用on()添加的那个相同的函数。否则,只通过事件类型调用此方法将移除该类型的所有处理程序。如果没有参数,将移出当前元素上全部的注册事件。

on

on(type, [selector], function(e){ ... })   => self
on(type, [selector], [data], function(e){ ... })   => self v1.1+
on({ type: handler, type2: handler2, ... }, [selector])   => self
on({ type: handler, type2: handler2, ... }, [selector], [data])   => self v1.1+

添加事件处理程序到对象集合中得元素上。多个事件可以通过空格的字符串方式添加,或者以事件类型为键、以函数为值的对象 方式。如果给定css选择器,当事件在匹配该选择器的元素上发起时,事件才会被触发(愚人码头注:即事件委派,或者说事件代理)。

如果给定data参数,这个值将在事件处理程序执行期间被作为有用的 event.data 属性

事件处理程序在添加该处理程序的元素、或在给定选择器情况下匹配该选择器的元素的上下文中执行(愚人码头注:this指向触发事件的元素)。 当一个事件处理程序返回falsepreventDefault()stopPropagation()被当前事件调用的情况下, 将防止默认浏览器操作,如链接。

如果false 在回调函数的位置上作为参数传递给这个方法, 它相当于传递一个函数,这个函数直接返回false。(愚人码头注:即将 false 当作 function(e){ ... } 的参数,作为 function(){ return false; } 的简写形式,例如: $("a.disabled").on("click", false);这相当于$("a.disabled").on("click", function(){ return false; } );

var elem = $('#content')
// observe all clicks inside #content:
elem.on('click', function(e){ ... })
// observe clicks inside navigation links in #content
elem.on('click', 'nav a', function(e){ ... })
// all clicks inside links in the document
$(document).on('click', 'a', function(e){ ... })
// disable following any navigation link on the page
$(document).on('click', 'nav a', false)

one

one(type, [selector], function(e){ ... })   => self
one(type, [selector], [data], function(e){ ... })   => self v1.1+
one({ type: handler, type2: handler2, ... }, [selector])   => self
one({ type: handler, type2: handler2, ... }, [selector], [data])   => self v1.1+

添加一个处理事件到元素,当第一次执行事件以后,该事件将自动解除绑定,保证处理函数在每个元素上最多执行一次。selectordata 等参数说明请查看.on()

trigger

trigger(event, [args])   => self

在对象集合的元素上触发指定的事件。事件可以是一个字符串类型,也可以是一个 通过$.Event 定义的事件对象。如果给定args参数,它会作为参数传递给事件函数。

// add a handler for a custom event
$(document).on('mylib:change', function(e, from, to){
  console.log('change on %o with data %s, %s', e.target, from, to)
})
// trigger the custom event
$(document.body).trigger('mylib:change', ['one', 'two'])

Zepto仅仅支持在dom元素上触发事件。

triggerHandler

triggerHandler(event, [args])   => self

trigger,它只在当前元素上触发事件,但不冒泡。

 $("input").triggerHandler('focus');
        // 此时input上的focus事件触发,但是input不会获取焦点
        $("input").trigger('focus');
        // 此时input上的focus事件触发,input获取焦点

unbind

Deprecated, use off instead.

unbind(type, function(e){ ... })   => self
unbind({ type: handler, type2: handler2, ... })   => self

移除通过 bind 注册的事件。

undelegate

Deprecated, use off instead.

undelegate(selector, type, function(e){ ... })   => self
undelegate(selector, { type: handler, type2: handler2, ... })   => self

移除通过delegate 注册的事件。

powered by Gitbook 该教程制作时间: 2016-01-03 17:26:50