目录搜索
jQuery 1.4.4 速查表核心jQuery核心函数jQuery(expressionjQuery(htmljQuery(htmljQuery(elements)jQuery()jQuery(callback)jQuery对象访问each(callback)size()lengthcontextget()get(index)index([subject])selector数据缓存data([name])data(namedata(obj)removeData(name)jQuery.data(elementjQuery.data([element]队列机制queue(name)queue(namequeue(namedequeue(name)clearQueue([queueName])插件机制jQuery.extend(object)jQuery.fn.extend(object)多库共存jQuery.noConflict()jQuery.noConflict(extreme)选择器基本#idelement.class*selector1层级ancestor descendantparent > childprev + nextprev ~ 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(keyattr(keyremoveAttr(name)CSS类addClass(class)addClass(function(indexremoveClass([class])removeClass(function(indextoggleClass(class)toggleClass(classtoggleClass(function(indexHTML代码html()html(val)html(function(index文本text()text(val)text(function(indexval()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(exprfind(expr)next([expr])nextAll([expr])nextUntil([expr])offsetParent()parent([expr])parents([expr])parentsUntil([expr])prev([expr])prevAll([expr])prevUntil([expr])siblings([expr])串联add(exprandSelf()contents()end()文档处理内部插入append(content)append(function(indexappendTo(content)prepend(content)prepend(function(indexprependTo(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)CSSCSScss(name)css(properties)css(namecss(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(typeone(typetrigger(typetriggerHandler(typeunbind([type]事件委派live(typedie([type]delegate(selectorundelegate()事件切换hover(overtoggle(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(speedhide()hide(speedtoggle()toggle(switch)toggle(speed滑动slideDown(speedslideUp(speedslideToggle(speed淡入淡出fadeIn(speedfadeOut(speedfadeTo(speedfadeToggle(speed自定义animate(paramsanimate(paramsstop([clearQueue]delay(duration设置jQuery.fx.offjQuery.fx.intervalAJAXAJAX请求jQuery.ajax([options])load(urljQuery.get(urljQuery.getJSON(urljQuery.getScript(urljQuery.post(urlAJAX事件ajaxComplete(callback)ajaxError(callback)ajaxSend(callback)ajaxStart(callback)ajaxStop(callback)ajaxSuccess(callback)其它jQuery.ajaxSetup([options])serialize()serializeArray()工具浏览器及特性检测jQuery.supportjQuery.browserjQuery.browser.versionjQuery.boxModel数组和对象操作jQuery.each(objectjQuery.extend([deep]jQuery.grep(arrayjQuery.inArray(valuejQuery.makeArray(obj)jQuery.toArray()jQuery.map(arrayjQuery.merge(firstjQuery.unique(array)jQuery.parseJSON(json)函数操作jQuery.noopjQuery.proxy(function测试操作jQuery.contains(containerjQuery.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及获取更新
文字

返回值: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();
});
上一篇:下一篇: