element 返回值:Array<Element(s)>
概述
根据给定的元素名匹配所有元素
参数
elementString
一个用于搜索的元素。指向 DOM 节点的标签名。
示例
描述:
查找一个 DIV 元素。
HTML 代码:
<div>DIV1</div>
<div>DIV2</div>
<span>SPAN</span>
jQuery 代码:
$("div");
结果:
[ <div>DIV1</div>, <div>DIV2</div> ]
...
context
概述
jQuery 1.3新增。返回传给jQuery()的原始的DOM节点内容,即jQuery()的第二个参数。如果没有指定,那么context指向当前的文档(document)。
可以与selector一起使用,用于精确检测选择器查询情况。这两个属性对插件开发人员很有用。
示例
描述:
检测使用的文档内容
jQuery 代码:
$("ul")
.append("<li>" + $("ul").context + "</li>")
.append("<li>" + $("ul", document.body).context.nodeName + "</li>");
结果:
[object HTMLDocument] //如果是IE浏览器,则返回[object]
BODY
...
jQuery(elements)
返回值:jQuery
概述
将一个或多个DOM元素转化为jQuery对象。
这个函数也可以接收XML文档和Window对象(虽然它们不是DOM元素)作为有效的参数。
参数
elementsElement, Array<Element>
用于封装成jQuery对象的DOM元素
示例
描述:
设置页面背景色。
jQuery 代码:
$(document.body).css( "background", "black" );
描述:
隐藏一个表单中所有元素。
jQuery 代码:
$(myForm.elements).hide()
...
jQuery(html, [ownerDocument])
返回值:jQuery
概述
根据提供的原始 HTML 标记字符串,动态创建由 jQuery 对象包装的 DOM 元素。
你可以传递一个手写的 HTML 字符串,或者由某些模板引擎或插件创建的字符串,也可以是通过 AJAX 加载过来的字符串。但是在你创建 input 元素的时会有限制,可以参考第二个示例。当然这个字符串可以包含斜杠 (比如一个图像地址),还有反斜杠。当你创建单个元素时,请使用闭合标签或 XHTML 格式。例如,创建一个 span ,可以用 $("<span/>") 或 $("<span></span>") ,但不推荐 $("<span>")。在jQuery 中,这个语法等同于$(...
jQuery(expression, [context])
概述
这个函数接收一个包含 CSS 选择器的字符串,然后用这个字符串去匹配一组元素。
jQuery 的核心功能都是通过这个函数实现的。 jQuery中的一切都基于这个函数,或者说都是在以某种方式使用这个函数。这个函数最基本的用法就是向它传递一个表达式(通常由 CSS 选择器组成),然后根据这个表达式来查找所有匹配的元素。
默认情况下, 如果没有指定context参数,$()将在当前的 HTML document中查找 DOM 元素;如果指定了 context 参数,如一个 DOM 元素集或 jQuery 对象,那就会在这个 context 中查找。在jQuery 1.3.2以后,其返回的元素顺序等同于在context中出现的先后顺序。
参考文...
getWidth [1.6.0]
document.viewport.getWidth() -> Number
返回当前窗口可视部分的宽度。
相当于调用 document.viewport.getDimensions().width。
到此,Prototype实战教程全部放送完毕,下面,我们将提供JQuery实战教程。
getScrollOffsets [1.6.0]
document.viewport.getScrollOffsets() -> [Number, Number] 或 { top: Number, left: Number }
返回当前窗口可视部分的水平和垂直滚动偏移值。
样例
document.viewport.getScrollOffsets();
//-> { left: 0, top: 0 }
window.scrollTo(0, 120);
document.viewport.getScrollOffsets();
//-> { left: 0, top: 120 }
...
getHeight [1.6.0]
document.viewport.getHeight() -> Number
返回当前窗口可视部分的高度。
相当于调用 document.viewport.getDimensions().height。
getDimensions [1.6.0]
document.viewport.getDimensions() -> { width: Number, height: Number }
返回当前窗口可视部分的尺寸。
viewport 是一个页面所占据的浏览器窗口的一个子集——在浏览器窗口中当前可见的部分。
样例
document.viewport.getDimensions();
//-> { width: 776, height: 580 }
getDimensions
getHeight
getScrollOffsets
getWidth
方法
getDimensions [1.6.0]
document.viewport.getDimensions() -> { width: Number, height: Number }
返回当前窗口可视部分的尺寸。
getHeight [1.6.0]
document.viewport.getHeight() -> Number
返回当前窗口可视部分的高度。
getScrollOffsets [1.6.0]
document.viewport.getScrollOffsets() -> [Number, Number] 或 { top: Number, left: Number }
返回当前窗口可视部分的水平和垂直滚动偏...
stopObserving [1.6.0]
document.stopObserving(eventName, handler[, useCapture = false]) -> document
为文档注销指定的事件处理程序。
document.stopObserving 是 Element#stopObserving 基于整个文档范围的版本。
observe [1.6.0]
observe(eventName, handler) -> document
侦听整个文档范围内的给定事件。也可以用于侦听 "dom:loaded" 事件。
document.observe 是 Element#observe 基于整个文档范围的版本。它与 Event.observe(document, eventName, handler) 是等价的。
"dom:loaded" 事件
Prototype 创建了一个确实非常有用的事件:你可能希望在文档的 DOM 树载入完成后,能够获取一个通知, 这就是所谓的 "dom:loaded" 事件。在支持 DOMContentLoaded 事件的浏览器上, Prototype 会在 DOMContentLoaded 事件上触发 "dom.loaded" 事件。对于不支...
fire [1.6.0]
fire(eventName[, memo]) -> Event
在 document 上触发一个自定义事件。
document.fire 是 Element#fire 基于整个文档范围的版本。
Form.Element.Observer
new Form.Element.Observer(element, frequency, callback)
一个针对指定表单控件的定时观察器。
Form.Element.Observer 使用 Form.Element.getValue() 实现 getValue() 方法。关于定时观察器的描述见 Abstract.TimedObserver。
offsetParent [不推荐]
offsetParent(element) -> HTMLElement
返回 element 的容器块(Containing Block)(译注:距离元素最近的 CSS position 属性为 relative 或 absolute 的先代节点)节点, 如果不存在这样一个节点,则返回 body 元素。
已被 Element#getOffsetParent 方法取代。
返回的元素是 element 的 CSS containing block。
isElement [1.6]
isElement(obj) -> Boolean
如果 obj 是一个 DOM 级别 1 的节点,返回 true,否则返回 false。
样例
Object.isElement(new Element('div'));
//-> true
Object.isElement(document.createElement('div'));
//-> true
Object.isElement($('id_of_an_exiting_element'));
//-> true
Object.isElement(document.createTextNode('foo'));
//-> false
...