trigger(type, [data]) 返回值:jQuery
概述
在每一个匹配的元素上触发某类事件。
这个函数也会导致浏览器同名的默认行为的执行。比如,如果用trigger()触发一个'submit',则同样会导致浏览器提交表单。如果要阻止这种默认行为,应返回false。
你也可以触发由bind()注册的自定义事件而不限于浏览器默认事件。
事件处理函数会收到一个修复的(规范化的)事件对象,但这个对象没有特定浏览器才有的属性,比如keyCode。
jQuery也支持 命名空间事件。这允许你触发或者解除绑定一组特定的事件处理函数,而无需一一个指定。你可以在事件类型后面加上感叹号 ! 来只触发那些没有命名空间的事件处理函数。
jQu...
one(type, [data], fn) 返回值:jQuery
概述
为每一个匹配元素的特定事件(像click)绑定一个一次性的事件处理函数。
在每个对象上,这个事件处理函数只会被执行一次。其他规则与bind()函数相同。这个事件处理函数会接收到一个事件对象,可以通过它来阻止(浏览器)默认的行为。如果既想取消默认的行为,又想阻止事件起泡,这个事件处理函数必须返回false。
多数情况下,可以把事件处理函数定义为匿名函数(见示例一)。在不可能定义匿名函数的情况下,可以传递一个可选的数据对象作为第二个参数(而事件处理函数则作为第三个参数),见示例二。
参数
typeString
事件类型
data (可选)Object...
bind(type, [data], fn) 返回值:jQuery
概述
为每一个匹配元素的特定事件(像click)绑定一个事件处理器函数。
这个事件处理函数会接收到一个事件对象,可以通过它来阻止(浏览器)默认的行为。如果既想取消默认的行为,又想阻止事件起泡,这个事件处理函数必须返回false。多数情况下,可以把事件处理器函数定义为匿名函数(见示例一)。在不可能定义匿名函数的情况下,可以传递一个可选的数据对象作为第二个参数(而事件处理器函数则作为第三个参数),见示例二。
参数
typeString
事件类型
data (可选)Object
作为event.data属性值传递给事件对象的额外数据对象
fnFunction
绑定到每个...
ready(fn) 返回值:jQuery
概述
当DOM载入就绪可以查询及操纵时绑定一个要执行的函数。
这是事件模块中最重要的一个函数,因为它可以极大地提高web应用程序的响应速度。
简单地说,这个方法纯粹是对向window.load事件注册事件的替代方法。通过使用这个方法,可以在DOM载入就绪能够读取并操纵时立即调用你所绑定的函数,而99.99%的JavaScript函数都需要在那一刻执行。
有一个参数--对jQuery函数的引用--会传递到这个ready事件处理函数中。可以给这个参数任意起一个名字,并因此可以不再担心命名冲突而放心地使用$别名。
请确保在 元素的onload事件中没有注册函数,否则不会触发$(document)...
outerWidth(options) 返回值:Integer
概述
获取第一个匹配元素外部宽度(默认包括补白和边框)。
此方法对可见和隐藏元素均有效。
参数
optionsBoolean默认值:'false'
设置为 true 时,计算边距在内。
示例
描述:
获取第一段落外部宽度。
HTML 代码:
<p>Hello</p><p>2nd Paragraph</p>
jQuery 代码:
var p = $("p:first");
$("p:last").text( "outerWidth:" + p.outerWidth() + " , outerWidth(true):" + p.outerWidth(true) );
结果:
<p>Hello</p><p>outerWidth: 65 , outer...
outerHeight(options) 返回值:Integer
概述
获取第一个匹配元素外部高度(默认包括补白和边框)。
此方法对可见和隐藏元素均有效。
参数
optionsBoolean默认值:'false'
设置为 true 时,计算边距在内。
示例
描述:
获取第一段落外部高度。
HTML 代码:
<p>Hello</p><p>2nd Paragraph</p>
jQuery 代码:
var p = $("p:first");
$("p:last").text( "outerHeight:" + p.outerHeight() + " , outerHeight(true):" + p.outerHeight(true) );
结果:
<p>Hello</p><p>outerHeight: 35 ,...
innerWidth() 返回值:Integer
概述
获取第一个匹配元素内部区域宽度(包括补白、不包括边框)。
此方法对可见和隐藏元素均有效。
示例
描述:
获取第一段落内部区域宽度。
HTML 代码:
<p>Hello</p><p>2nd Paragraph</p>
jQuery 代码:
var p = $("p:first");
$("p:last").text( "innerWidth:" + p.innerWidth() );
结果:
<p>Hello</p><p>innerWidth: 40</p>
...
innerHeight() 返回值:Integer
概述
获取第一个匹配元素内部区域高度(包括补白、不包括边框)。
此方法对可见和隐藏元素均有效。
示例
描述:
获取第一段落内部区域高度。
HTML 代码:
<p>Hello</p><p>2nd Paragraph</p>
jQuery 代码:
var p = $("p:first");
$("p:last").text( "innerHeight:" + p.innerHeight() );
结果:
<p>Hello</p><p>innerHeight: 16</p>
...
width(val) 返回值:jQuery
概述
为每个匹配的元素设置CSS宽度(width)属性的值。
如果没有明确指定单位(如:em或%),使用px。
参数
valString, Number
设定 CSS 'width' 的属性值
示例
描述:
将所有段落的宽设为 20:
jQuery 代码:
$("p").width(20);
width() 返回值:Integer
概述
取得第一个匹配元素当前计算的宽度值(px)。
在 jQuery 1.2 以后可以用来获取 window 和 document 的宽
示例
描述:
获取第一段的宽
jQuery 代码:
$("p").width();
描述:
获取当前窗口的宽
jQuery 代码:
$(window).width();
height(val) 返回值:jQuery
概述
为每个匹配的元素设置CSS高度(hidth)属性的值。如果没有明确指定单位(如:em或%),使用px。
如果没有明确指定单位(如:em或%),使用px。
参数
valString, Number
设定CSS中 'height' 的值
示例
描述:
把所有段落的高设为 20:
jQuery 代码:
$("p").height(20);
height() 返回值:Integer
概述
取得第一个匹配元素当前计算的高度值(px)。
在 jQuery 1.2 以后可以用来获取 window 和 document 的高
示例
描述:
获取第一段的高
jQuery 代码:
$("p").height();
描述:
获取文档的高
jQuery 代码:
$(document).height();
scrollLeft(val) 返回值:jQuery
概述
传递参数值时,设置水平滚动条左侧偏移为该值。
此方法对可见和隐藏元素均有效。
参数
valString, Number
设定水平滚动条值
示例
描述:
设置相对滚动条左侧的偏移
jQuery 代码:
$("div.demo").scrollLeft(300);
scrollLeft() 返回值:Integer
概述
获取匹配元素相对滚动条左侧的偏移。
此方法对可见和隐藏元素均有效。
示例
描述:
获取第一段相对滚动条左侧的偏移
HTML 代码:
<p>Hello</p><p>2nd Paragraph</p>
jQuery 代码:
var p = $("p:first");
$("p:last").text( "scrollLeft:" + p.scrollLeft() );
结果:
<p>Hello</p><p>scrollLeft: 0</p>
...
scrollTop(val) 返回值:jQuery
概述
传递参数值时,设置垂直滚动条顶部偏移为该值。
此方法对可见和隐藏元素均有效。
参数
valString, Number
设定垂直滚动条值
示例
描述:
设置相对滚动条顶部的偏移
jQuery 代码:
$("div.demo").scrollTop(300);
scrollTop() 返回值:Integer
概述
获取匹配元素相对滚动条顶部的偏移。
此方法对可见和隐藏元素均有效。
示例
描述:
获取第一段相对滚动条顶部的偏移
HTML 代码:
<p>Hello</p><p>2nd Paragraph</p>
jQuery 代码:
var p = $("p:first");
$("p:last").text( "scrollTop:" + p.scrollTop() );
结果:
<p>Hello</p><p>scrollTop: 0</p>
...