directory search
jQuery 1.4.4 速查表 核心 jQuery核心函数 jQuery(expression jQuery(html jQuery(html jQuery(elements) jQuery() jQuery(callback) jQuery对象访问 each(callback) size() length context get() get(index) index([subject]) selector 数据缓存 data([name]) data(name data(obj) removeData(name) jQuery.data(element jQuery.data([element] 队列机制 queue(name) queue(name queue(name dequeue(name) clearQueue([queueName]) 插件机制 jQuery.extend(object) jQuery.fn.extend(object) 多库共存 jQuery.noConflict() jQuery.noConflict(extreme) 选择器 基本 #id element .class * selector1 层级 ancestor descendant parent > child prev + next prev ~ siblings 基本(过滤器) :first :last :not :even :odd :eq :gt :lt :header :animated 内容(过滤器) :contains :empty :has :parent 可见性(过滤器) :hidden :visible 属性 [attribute] [attribute=value] [attribute!=value] [attribute^=value] [attribute$=value] [attribute*=value] [selector1][selector2][selectorN] 子元素 :first-child :last-child :nth-child :only-child 表单 :input :text :password :radio :checkbox :reset :submit :image :button :file :hidden 表单对象属性 :checked :disabled :enabled :selected 属性 属性 attr(name) attr(properties) attr(key attr(key removeAttr(name) CSS类 addClass(class) addClass(function(index removeClass([class]) removeClass(function(index toggleClass(class) toggleClass(class toggleClass(function(index HTML代码 html() html(val) html(function(index 文本 text() text(val) text(function(index val() val(val) val(array) val(function(index 筛选 过滤 eq(index) first() last() hasClass(class) filter(expr) filter(fn) is(expr) map(callback) has(expr) not(expr) slice(start 查找 children([expr]) closest(expr find(expr) next([expr]) nextAll([expr]) nextUntil([expr]) offsetParent() parent([expr]) parents([expr]) parentsUntil([expr]) prev([expr]) prevAll([expr]) prevUntil([expr]) siblings([expr]) 串联 add(expr andSelf() contents() end() 文档处理 内部插入 append(content) append(function(index appendTo(content) prepend(content) prepend(function(index prependTo(content) 外部插入 after(content) after(function) before(content) before(function) insertAfter(content) insertBefore(content) 包裹 wrap(html) wrap(elem) wrap(fn) unwrap() wrapAll(html) wrapAll(elem) wrapInner(html) wrapInner(elem) wrapInner(fn) 替换 replaceWith(content) replaceAll(selector) 删除 empty() remove([expr]) detach([expr]) 复制 clone() clone(true) CSS CSS css(name) css(properties) css(name css(name 位置 offset() offset(coordinates) position() scrollLeft() scrollLeft(val) scrollTop() scrollTop(val) 尺寸 height() height(val) width() width(val) innerHeight() innerWidth() outerHeight(options) outerWidth(options) 事件 页面载入 ready(fn) 事件处理 bind(type one(type trigger(type triggerHandler(type unbind([type] 事件委派 live(type die([type] delegate(selector undelegate() 事件切换 hover(over toggle(fn 事件 blur() blur(fn) change() change(fn) click() click(fn) dblclick() dblclick(fn) error() error(fn) focus() focus(fn) focusin(fn) focusout(fn) keydown() keydown(fn) keypress() keypress(fn) keyup() keyup(fn) load(fn) mousedown(fn) mousemove(fn) mouseout(fn) mouseover(fn) mouseup(fn) resize(fn) scroll(fn) select() select(fn) submit() submit(fn) unload(fn) 效果 基本 show() show(speed hide() hide(speed toggle() toggle(switch) toggle(speed 滑动 slideDown(speed slideUp(speed slideToggle(speed 淡入淡出 fadeIn(speed fadeOut(speed fadeTo(speed fadeToggle(speed 自定义 animate(params animate(params stop([clearQueue] delay(duration 设置 jQuery.fx.off jQuery.fx.interval AJAX AJAX请求 jQuery.ajax([options]) load(url jQuery.get(url jQuery.getJSON(url jQuery.getScript(url jQuery.post(url AJAX事件 ajaxComplete(callback) ajaxError(callback) ajaxSend(callback) ajaxStart(callback) ajaxStop(callback) ajaxSuccess(callback) 其它 jQuery.ajaxSetup([options]) serialize() serializeArray() 工具 浏览器及特性检测 jQuery.support jQuery.browser jQuery.browser.version jQuery.boxModel 数组和对象操作 jQuery.each(object jQuery.extend([deep] jQuery.grep(array jQuery.inArray(value jQuery.makeArray(obj) jQuery.toArray() jQuery.map(array jQuery.merge(first jQuery.unique(array) jQuery.parseJSON(json) 函数操作 jQuery.noop jQuery.proxy(function 测试操作 jQuery.contains(container jQuery.isArray(obj) jQuery.isFunction(obj) jQuery.isEmptyObject(obj) jQuery.isPlainObject(obj) jQuery.isWindow(obj) jQuery.type(obj) 字符串操作 jQuery.trim(str) URL解析 jQuery.param(obj 插件编写 jQuery.error(message) 关于 关于jQuery API 1.4.4中文版 关于jQuery 1.4.1中文版 关于jQuery 1.3 版翻译 关于jQuery 1.2 版翻译 提交bug及获取更新
characters

返回值:jQuerylive(type, [data], fn)

概述

jQuery 给所有匹配的元素附加一个事件处理函数,即使这个元素是以后再添加进来的也有效。

这个方法是基本是的 .bind() 方法的一个变体。使用 .bind() 时,选择器匹配的元素会附加一个事件处理函数,而以后再添加的元素则不会有。为此需要再使用一次 .bind() 才行。比如说

<pre>&lt;body&gt;
  &lt;div class="clickme"&gt;Click here&lt;/div&gt;
&lt;/body&gt;
</pre>

可以给这个元素绑定一个简单的click事件:

<pre>$('.clickme').bind('click', function() {
  alert("Bound handler called.");
});
</pre>

当点击了元素,就会弹出一个警告框。然后,想象一下这之后有另一个元素添加进来了。

<pre>$('body').append('&lt;div class="clickme"&gt;Another target&lt;/div&gt;');</pre>

尽管这个新的元素也能够匹配选择器 ".clickme" ,但是由于这个元素是在调用 .bind() 之后添加的,所以点击这个元素不会有任何效果。

.live() 就提供了对应这种情况的方法。如果我们是这样绑定click事件的:

<pre>$('.clickme').live('click', function() {
  alert("Live handler called."); 
});</pre>

然后再添加一个新元素:

<pre>$('body').append('&lt;div class="clickme"&gt;Another target&lt;/div&gt;');</pre>

然后再点击新增的元素,他依然能够触发事件处理函数。

'''事件委托'''

.live() 方法能对一个还没有添加进DOM的元素有效,是由于使用了事件委托:绑定在祖先元素上的事件处理函数可以对在后代上触发的事件作出回应。传递给 .live() 的事件处理函数不会绑定在元素上,而是把他作为一个特殊的事件处理函数,绑定在 DOM 树的根节点上。在我们的例子中,当点击新的元素后,会依次发生下列步骤:

  <ol>
    <li>生成一个click事件传递给 &lt;div&gt; 来处理 </li>
    <li>由于没有事件处理函数直接绑定在 &lt;div&gt; 上,所以事件冒泡到DOM树上</li>
    <li>事件不断冒泡一直到DOM树的根节点,默认情况下上面绑定了这个特殊的事件处理函数。</li>
    <li>执行由 .live() 绑定的特殊的 click 事件处理函数。</li>
    <li>这个事件处理函数首先检测事件对象的 target 来确定是不是需要继续。这个测试是通过检测 $(event.target).closest('.clickme') 能否找到匹配的元素来实现的。</li>
    <li>如果找到了匹配的元素,那么调用原始的事件处理函数。</li>
  </ol>

由于只有在事件发生时才会在上面的第五步里做测试,因此在任何时候添加的元素都能够响应这个事件。

'''附加说明'''

.live() 虽然很有用,但由于其特殊的实现方式,所以不能简单的在任何情况下替换 .bind()。主要的不同有:

<ul>
	<li>在jQuery 1.4中,.live()方法支持自定义事件,也支持所有的 JavaScript 事件。在jQuery 1.4.1中,甚至也支持 focus 和 blue 事件了(映射到更合适,并且可以冒泡的focusin和focusout上)。另外,在jQuery 1.4.1中,也能支持hover(映射到"mouseenter mouseleave")。然而在jQuery 1.3.x中,只支持支持的JavaScript事件和自定义事件:click, dblclick, keydown, keypress, keyup, mousedown, mousemove, mouseout, mouseover, 和 mouseup.</li>
	<li>.live() 并不完全支持通过DOM遍历的方法找到的元素。取而代之的是,应当总是在一个选择器后面直接使用 .live() 方法,正如前面例子里提到的。</li>
	<li>当一个事件处理函数用 .live() 绑定后,要停止执行其他的事件处理函数,那么这个函数必须返回 false。 仅仅调用 .stopPropagation() 无法实现这个目的。</li>
</ul>

参考 .bind() 方法可以获得更多关于事件绑定的信息。

在jQuery 1.4.1中,你可以一次绑定多个事件给 .live() ,跟 .bind() 提供的功能类似。

在jQuery 1.4 中,data参数可以用于把附加信息传递给事件处理函数。一个很好的用处是应付由闭包导致的问题。可以参考 .bind() 的讨论来获得更多信息。

参数

typeString

事件类型

data (可选)Object

欲绑定的事件处理函数

fnFunction

欲绑定的事件处理函数

示例

描述:

点击生成的p依然据有同样的功能。

HTML 代码:
<p>Click me!</p>
jQuery 代码:
$("p").live("click", function(){
    $(this).after("<p>Another paragraph!</p>");
});

描述:

阻止默认事件行为和事件冒泡,返回 false

jQuery 代码:
$("a").live("click", function() { return false; });

描述:

仅仅阻止默认事件行为

jQuery 代码:
$("a").live("click", function(event){
  event.preventDefault();
});
Previous article: Next article: