().Prototype1.5 rc2)使用指南之dom.js

这部分提供了很多(写的都有点烦了)方便的操作dom的方法:包含有名的$方法、document.getElementsByClassName方法,以及Element对象、Insertion对象

以下部分一个一个的详细介绍:

$(element)getElementById的封装,element可以是一个元素的id或元素本身,也可以是一个数组,这时返回一个数组,使用$方法,会自动调用Element.extend(element)方法,这样的话使元素可以直接调用 Element中的方法, 例如Element.hide(element)可以写成这样$(element).hide()

document.getElementsByClassName(className, parentElement): 根据class选择元素

Element.extend(element): 扩展element,使element可以直接调用ElementForm.ElementForm中定义的方法

Element对象的方法:

visible: function(element):判断element是否可见, 参数element可以是元素本身或元素id(下面的方面的参数基本上都是这样的)

toggle: function(element):反转element的可见性

hide: function(element):隐藏元素

show: function(element):显示元素

remove: function(element):移除元素

update: function(element, html) :使用html更新element的内容,html中的script会执行(下同)

replace: function(element, html):将element替换为html

inspect: function(element)element的字符串表示

recursivelyCollect: function(element, property): 递归收集, 例如Element.recursivelyCollect(element, "parentNode")返回element所有的祖先节点, 注意只返回nodeType == 1的元素,也就是不返回文本元素

ancestors: function(element): 等同于上面的例子,返回元素的所有祖先节点

descendants: function(element): 返回所有子孙节点

immediateDescendants: function(element):返回元素的直接的子孙节点(子节点)的数组

previousSiblings: function(element):返回元素前面的兄弟节点

nextSiblings: function(element):返回位于元素后面的兄弟节点

siblings: function(element):返回元素所有的兄弟节点

match: function(element, selector):使用Selectormatch方法匹配元素(Selector将在后面介绍), selector参数是一个css selector表达式或者Prototype中的一个Selector实例,如果element匹配selector则返回true,否则返回 false,例如对于一个classNamelogcssdiv来说,下面的表达式返回true, $(element).match("div.logcss") 待续。。

up(element, expression, index):利用Selector.findElement方法找到element元素的祖先节点中符合表达式expression的所有元素组成的数组索引为index的元素,也可以忽略expression(默认为*,表示匹配所有元素)index(默认为0),直接这样调用up(element, index)up(element)

down(element, expression, index):跟up一样,只是返回的是子孙节点

previous(element, expression, index):返回前面的兄弟节点

next(element, expression, index):返回后面的兄弟节点

getElementsBySelector(element,args)Selector.findChildElements(element, args)的封装,args表示可以传递多个参数,每个参数是一个css selector表达式,返回element的子孙节点中符合任何一个css selector表达式的元素组成的数组

getElementsByClassName(element, className):返回element中的子孙节点中符合clsssName的元素

readAttribute(element, name)return $(element).getAttribute(name),之所以添加这个方法是因为在IESafari(Mac)getAttribute不是一个真正的函数,它没有callapply等方法,所以在很多时候调用会出现错误(Prototype中很多地方使用了函数的这两个方法),例如下面的例子(官方文档中的一个例子),就只能使用readAttribute

<div id="widgets">

 <div class="widget" widget_id="7">…</div>

 <div class="widget" widget_id="8">…</div>

 <div class="widget" widget_id="9">…</div>

</div>

$$(’div.widget’).invoke(’readAttribute’, 'widget_id’)

// ["7", "8", "9"]

getHeight: function(element):返回元素高度,return element.offsetHeight

classNames: function(element):返回一个Element.ClassNames对象,改对象提供对元素class的操作,包括addremoveset等,一般很少使用,使用Element.addClassName等方法就可以了(就在下面)

hasClassName: function(element, className) :判断element是否含有className

addClassName: function(element, className) :给element添加一个class

removeClassName: function(element, className) :移除元素中的一个class

observe():调用Event对象(Prototype中的,将在后面介绍)observe方法为元素注册事件handle

stopObserving() :移除注册的事件handle

cleanWhitespace: function(element):移除元素中空白的文本子节点

empty: function(element):判断元素是否为空

childOf: function(element, ancestor) :判断element是否为ancestor的子孙节点

scrollTo: function(element) :滚动条移动到元素所在的地方

getStyle: function(element, style) :得到元素某个css样式的值,例如$(element).getStyle("float")

setStyle: function(element, style) :设置元素的css样式,style十一个对象,例如element.setStyle({left: "40px", "background-color":"#666"})

getDimensions: function(element) :得到元素的尺寸,即使元素是隐藏的也可以正确的返回,返回 return {width: originalWidth, height: originalHeight}这样的关联数组

makePositioned: function(element) :当元素的position css属性为static或不存在使,将次属性更改为relative

undoPositioned: function(element) :跟makePositioned相反的操作

makeClipping: function(element) :把元素变成clipping(切片),也就是设置元素的overflow属性为hidden

undoClipping: function(element):反转上面的方法对元素所做的修改

hasAttribute(element):判断元素是否有某个属性

Element对象的方法是不是不少啊,哈哈,下面介绍有关Insertion的四个类

Insertion.Before:将内容插入到元素的前面,内容在元素外面

Insertion.Top:将内容插入到元素的顶部,内容在元素里面

Insertion.Bottom:将内容插入到元素的底部,内容在元素里面

Insertion.After:将内容插入到元素后面,内容在元素外面

使用它们的方法比较简单:new Insertion.where(element, content),其中where表示上面的BeforeTop等,contenthtml字符串,注意其中javascript片断会执行

终于写完了,PrototypeElement方法还真不少

虽然以前觉得自己对Prototype还比较熟悉,写的也有点累,但是发现自己收获仍然挺大的,为了写出这些方法的具体作用和用法,必须强迫自己一行行的把Prototype的代码弄清楚,使自己对Prototype中很多精巧的写法有了更深刻的认识和理解

写这个教程的主要目的是为了给大家一个快速的参考,大家还是对照着源代码看才会真正有所提高

这时我第一次写比较完整的一个教程,错误幼稚的地方在所难免,希望大家批评指正,互相学习提高,

().Prototype使用指南之Selector

Selector是利用css selector来匹配选择页面元素的,所以要理解Selector首先应该对css selector有所理解,下面是css2 selector的语法,当然很多浏览器只是支持其中的一部分,Prototype 中的Selector主要支持tag选择器、class选择器和id选择器,还有属性(attribute)选择器,基本上包含我们平时所用的所有类型

The following table summarizes CSS2 selector syntax, 详细的可以看http://www.w3.org/TR/REC-CSS2/selector.html:

Pattern

Meaning

Described in section

*

Matches any element.

Universal selector

E

Matches any E element (i.e., an element of type E).

Type selectors

E F

Matches any F element that is a descendant of an E element.

Descendant selectors

E > F

Matches any F element that is a child of an element E.

Child selectors

E:first-child

Matches element E when E is the first child of its parent.

The :first-child pseudo-class

E:link E:visited

Matches element E if E is the source anchor of a hyperlink of which the target is not yet visited (:link) or already visited (:visited).

The link pseudo-classes

E:active E:hover E:focus

Matches E during certain user actions.

The dynamic pseudo-classes

E:lang(c)

Matches element of type E if it is in (human) language c (the document language specifies how language is determined).

The :lang() pseudo-class

E + F

Matches any F element immediately preceded by an element E.

Adjacent selectors

E[foo]

Matches any E element with the “foo” attribute set (whatever the value).

Attribute selectors

E[foo=”warning”]

Matches any E element whose “foo” attribute value is exactly equal to “warning”.

Attribute selectors

E[foo~=”warning”]

Matches any E element whose “foo” attribute value is a list of space-separated values, one of which is exactly equal to “warning”.

Attribute selectors

E[lang|=”en”]

Matches any E element whose “lang” attribute has a hyphen-separated list of values beginning (from the left) with “en”.

Attribute selectors

DIV.warning

HTML only. The same as DIV[class~=”warning”].

Class selectors

E#myid

Matches any E element ID equal to “myid”.

ID selectors

Selector中包含Selector对象和类,

Selector对象具有下面两个方法:

match(element):元素是否与本selector匹配,在Element中已经介绍了
findElements(parentNode)parentNode中所有匹配本selector的子孙元素列表

使用方法也很简单 var s=new Selector(expression); s.match(element); s.findElements($(element)),其中expression可以是如下方式 "div""#id"".class""div#id""div[attribute]""div[attribute=fff]""div[attribute!=sdf]"

其中Selector也有几个静态方法,它们分别是:

matchElements(elements, expression):返回elements中符合expression的元素列表
findElement(elements, expression, index):返回elements中符合expression的元素列表中索引为index的元素
findChildElements(element, expressions):找出element的子孙元素中符合expressions的元素列表,其中expressions是一个expression数组,其中的expression支持"div li.#id"形式

$$方法:只是简单的调用return Selector.findChildElements(document, $A(arguments))

虽然Selector有这么多方法,但是大部分都是内部调用的,我们一般都很少使用,因为我们有个一个方便的方法$$,对于绝大部分情况已经足够了



------君临天下,舍我其谁------