prototype Element學(xué)習(xí)筆記(篇二)
更新時(shí)間:2008年10月26日 00:40:52 作者:
這一篇主要是要總論Element的所有函數(shù)。
所有函數(shù)的第一個(gè)參數(shù)都為:element,表示要操作的元素的引用,這是為了方面在Element.extend時(shí),把這些方法加入到DOM對(duì)象中去,用的是methodize函數(shù)。調(diào)用的時(shí)候不需要輸入第一個(gè)參數(shù)了,如:
var b=$('div1').visible();
另外,幾乎所有函數(shù)都會(huì)返回自身,注意,擴(kuò)展后的元素的類型為:HTMLElement,之所以這么做,有一個(gè)好處,就是方便連寫(xiě)代碼,如:
$('div1').update().insert('這是新插入的內(nèi)容');
這樣寫(xiě)代碼有一個(gè)好處,可讀性強(qiáng),且易于書(shū)寫(xiě)。
下面是函數(shù)介紹:
visible(element):Boolean
元素是否可見(jiàn)(依靠element.style.display)
toggle(element):HTMLElement
元素可見(jiàn)則使之不可見(jiàn),不可見(jiàn)則使之可見(jiàn)。再返回元素本身的引用。(依靠element.style.display)
hide(element):HTMLElement
隱藏元素。(依靠element.style.display)
show(element):HTMLElement
顯示元素。(依靠element.style.display)
remove(element):HTMLElement
刪除元素自身(刪除后返回被刪除的元素)。
update(element, content):HTMLElement
類似于element.innerHTML,加入了處理腳本等等功能。它先插入內(nèi)容,然后再執(zhí)行content中的腳本。
replace(element, content):HTMLElement
替換當(dāng)前元素。并返回被替換的元素。
insert(element, insertions):HTMLElement
在element的指定位置插入內(nèi)容,insertions的值如下:
string/number/element,例如:'this is the string to insert!!',默認(rèn)被插到元素的bottom位置。
{top:xxxxx,bottom:yyyy,before:zzzzz,after:aaaa},例如:{top:'this the content you will insert!'}。
返回值為element。
wrap(element, wrapper, attributes):HTMLElement
在element外面再罩一個(gè)元素。通常用于做遮罩。
wrapper:elementId、element、tagName、attrbutes(當(dāng)創(chuàng)建的罩為div時(shí),可省略標(biāo)簽設(shè)置)
attributes:一個(gè)JSON對(duì)象,用于設(shè)置元素的樣式,如:{color:"red",backgroundImage:"url(header.gif)"}
$('win1').wrap('div1',{color:“#666”});
$('win1').wrap('span',{font-size:12});
$('win1').wrap({color:“#666”});
返回創(chuàng)建的遮罩的引用。
inspect(element):string
生成一個(gè)表示當(dāng)前元素的字符串,例如:<div id='xxx' class='xxx'>,它只得兩個(gè)屬性,不等于toHTML()。
recursivelyCollect(element, property):HTMLElement[]
不好描述,例如:$('div1').recursivelyCollect('firstchild'),它返回div1中的所有是長(zhǎng)子身份的元素。
ancestors(element):HTMLElement[]
返回此元素的所有嫡系祖先,例如:如果有元素div1,它的父親是div2,div2的,父親是div3,就是這樣一直調(diào)用下去。
descendants(element):HTMLElement[]
返回所有子孫元素結(jié)點(diǎn)的數(shù)組。等于element.select('*')。
firstDescendant(element):HTMLElement
返回第一個(gè)兒子。所有兒子(不包括孫子、曾孫……哦)。
immediateDescendants(element):HTMLElement[]
返回所有兒子(不包括孫子、曾孫……哦)。
previousSiblings(element):HTMLElement[]
返回所有兄長(zhǎng)。
nextSiblings(element):HTMLElement[]
返回所有弟弟。
siblings(element):HTMLElement[]
返回所有兄弟,且按“從大到小”(在html中的出現(xiàn)順序)的順序排序。
match(element, selector):Boolean
元素是否滿足指定的選擇符
up(element, expression, index):HTMLElement
element.ancestors()中,滿足表達(dá)式expression的數(shù)組中,第index個(gè)元素,示例如下:
$('div1').up('div',1)返回直接祖先中,標(biāo)簽為div的,且序號(hào)為1的元素的引用。
down(element, expression, index):HTMLElement
返回子孫中,第index個(gè)滿足選擇符expression的元素。
previous(element, expression, index):HTMLElement
previous(element, expression, index):HTMLElement
這兩個(gè)沒(méi)懸念,返回前一個(gè)、后一個(gè),前n個(gè)、后n個(gè)。
select(element,selector1,selector2,……):HTMLElement[]
返回子孫中,滿足選擇符的元素的數(shù)組,多個(gè)選擇符之間是并集關(guān)系。
adjacent(element,selector):HTMLElement[]
返回所有滿足選擇符的兄弟,不包括自己。
identify(element):string
有id的返回已有id,沒(méi)有的則取一個(gè)id。并返回。
readAttribute(element, name):string
讀屬性
writeAttribute(element, name, value):HTMLElement
寫(xiě)屬性
?。剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑?
上面的函數(shù)用于查詢、雜務(wù),下面的函數(shù)一般用于獲取、設(shè)置各種坐標(biāo),在網(wǎng)頁(yè)中,一個(gè)元素的常用坐標(biāo)有好幾種,不外如下:
一、相對(duì)于文檔左上角的
二、相對(duì)于視區(qū)左上角的
三、相對(duì)于某一個(gè)元素的
縱觀各個(gè)框架中的代碼,求取坐標(biāo)不外是這三種。下面略述一二。
getHeight(element)、getWidth(element),相當(dāng)于求clientHeight、clientWidth。
classNames(element):Element.ClassNames
hasClassName(element, className):Boolean
addClassName(element, className):HTMLElement
removeClassName(element, className):HTMLElement
toggleClassName(element, className):HTMLElement
cleanWhitespace(element):HTMLElement,刪除空白文本節(jié)點(diǎn)
empty(element):Boolean,元素是否內(nèi)容為空白
descendantOf(element, ancestor):Boolean,判斷是元素是否為某一元素的子孫,ancestor為id或元素引用。
scrollTo(element):HTMLElement,滾動(dòng)到此元素,并返回此元素的引用。
getStyle(element, style):類型不定,返回元素的某一樣式的值。
getOpacity(element):Float,返回透明度。
setStyle(element, styles):HTMLElement,設(shè)置元素的樣式,styles是一個(gè)JSON對(duì)象。
setOpacity(element, value):HTMLElement,設(shè)置元素的透明度。
getDimensions(element):{width:x,height:y}。返回clientWidth,clientHeight。
makePositioned(element):HTMLElement,將position設(shè)為relative。不把位置設(shè)成當(dāng)前位置的。
undoPositioned(element):HTMLElement,將元素的position設(shè)為默認(rèn)值。
makeClipping(element):HTMLElement,設(shè)置元素的溢出。
undoClipping(element):HTMLElement,清除溢出。
cumulativeOffset(element):Element._returnOffset,獲取相對(duì)整個(gè)頁(yè)面的offset。
positionedOffset(element):Element._returnOffset,獲取相對(duì)于第一個(gè)position不是static的元素offset。如果都是static,則是相對(duì)于頁(yè)面。
absolutize(element):HTMLElement,把position設(shè)成absolute,并把位置設(shè)置成當(dāng)前位置。
relativize(element):HTMLElement,把position設(shè)成ralative,并把位置設(shè)成當(dāng)前位置。
cumulativeScrollOffset(element):Element._returnOffset,相對(duì)于頂層容器的scrollOffset的總和,不一定是文檔哦,因?yàn)轫?yè)面中有iframe就不是了。
getOffsetParent(element):HTMLElement,研究過(guò)css的就好說(shuō),不用多言了。
viewportOffset(element):Element._returnOffset,求相對(duì)于視區(qū)左上角的偏移量。
clonePosition(element, source):HTMLElement,從source克隆位置屬性到自身。
var b=$('div1').visible();
另外,幾乎所有函數(shù)都會(huì)返回自身,注意,擴(kuò)展后的元素的類型為:HTMLElement,之所以這么做,有一個(gè)好處,就是方便連寫(xiě)代碼,如:
$('div1').update().insert('這是新插入的內(nèi)容');
這樣寫(xiě)代碼有一個(gè)好處,可讀性強(qiáng),且易于書(shū)寫(xiě)。
下面是函數(shù)介紹:
visible(element):Boolean
元素是否可見(jiàn)(依靠element.style.display)
toggle(element):HTMLElement
元素可見(jiàn)則使之不可見(jiàn),不可見(jiàn)則使之可見(jiàn)。再返回元素本身的引用。(依靠element.style.display)
hide(element):HTMLElement
隱藏元素。(依靠element.style.display)
show(element):HTMLElement
顯示元素。(依靠element.style.display)
remove(element):HTMLElement
刪除元素自身(刪除后返回被刪除的元素)。
update(element, content):HTMLElement
類似于element.innerHTML,加入了處理腳本等等功能。它先插入內(nèi)容,然后再執(zhí)行content中的腳本。
replace(element, content):HTMLElement
替換當(dāng)前元素。并返回被替換的元素。
insert(element, insertions):HTMLElement
在element的指定位置插入內(nèi)容,insertions的值如下:
string/number/element,例如:'this is the string to insert!!',默認(rèn)被插到元素的bottom位置。
{top:xxxxx,bottom:yyyy,before:zzzzz,after:aaaa},例如:{top:'this the content you will insert!'}。
返回值為element。
wrap(element, wrapper, attributes):HTMLElement
在element外面再罩一個(gè)元素。通常用于做遮罩。
wrapper:elementId、element、tagName、attrbutes(當(dāng)創(chuàng)建的罩為div時(shí),可省略標(biāo)簽設(shè)置)
attributes:一個(gè)JSON對(duì)象,用于設(shè)置元素的樣式,如:{color:"red",backgroundImage:"url(header.gif)"}
$('win1').wrap('div1',{color:“#666”});
$('win1').wrap('span',{font-size:12});
$('win1').wrap({color:“#666”});
返回創(chuàng)建的遮罩的引用。
inspect(element):string
生成一個(gè)表示當(dāng)前元素的字符串,例如:<div id='xxx' class='xxx'>,它只得兩個(gè)屬性,不等于toHTML()。
recursivelyCollect(element, property):HTMLElement[]
不好描述,例如:$('div1').recursivelyCollect('firstchild'),它返回div1中的所有是長(zhǎng)子身份的元素。
ancestors(element):HTMLElement[]
返回此元素的所有嫡系祖先,例如:如果有元素div1,它的父親是div2,div2的,父親是div3,就是這樣一直調(diào)用下去。
descendants(element):HTMLElement[]
返回所有子孫元素結(jié)點(diǎn)的數(shù)組。等于element.select('*')。
firstDescendant(element):HTMLElement
返回第一個(gè)兒子。所有兒子(不包括孫子、曾孫……哦)。
immediateDescendants(element):HTMLElement[]
返回所有兒子(不包括孫子、曾孫……哦)。
previousSiblings(element):HTMLElement[]
返回所有兄長(zhǎng)。
nextSiblings(element):HTMLElement[]
返回所有弟弟。
siblings(element):HTMLElement[]
返回所有兄弟,且按“從大到小”(在html中的出現(xiàn)順序)的順序排序。
match(element, selector):Boolean
元素是否滿足指定的選擇符
up(element, expression, index):HTMLElement
element.ancestors()中,滿足表達(dá)式expression的數(shù)組中,第index個(gè)元素,示例如下:
$('div1').up('div',1)返回直接祖先中,標(biāo)簽為div的,且序號(hào)為1的元素的引用。
down(element, expression, index):HTMLElement
返回子孫中,第index個(gè)滿足選擇符expression的元素。
previous(element, expression, index):HTMLElement
previous(element, expression, index):HTMLElement
這兩個(gè)沒(méi)懸念,返回前一個(gè)、后一個(gè),前n個(gè)、后n個(gè)。
select(element,selector1,selector2,……):HTMLElement[]
返回子孫中,滿足選擇符的元素的數(shù)組,多個(gè)選擇符之間是并集關(guān)系。
adjacent(element,selector):HTMLElement[]
返回所有滿足選擇符的兄弟,不包括自己。
identify(element):string
有id的返回已有id,沒(méi)有的則取一個(gè)id。并返回。
readAttribute(element, name):string
讀屬性
writeAttribute(element, name, value):HTMLElement
寫(xiě)屬性
?。剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑剑?
上面的函數(shù)用于查詢、雜務(wù),下面的函數(shù)一般用于獲取、設(shè)置各種坐標(biāo),在網(wǎng)頁(yè)中,一個(gè)元素的常用坐標(biāo)有好幾種,不外如下:
一、相對(duì)于文檔左上角的
二、相對(duì)于視區(qū)左上角的
三、相對(duì)于某一個(gè)元素的
縱觀各個(gè)框架中的代碼,求取坐標(biāo)不外是這三種。下面略述一二。
getHeight(element)、getWidth(element),相當(dāng)于求clientHeight、clientWidth。
classNames(element):Element.ClassNames
hasClassName(element, className):Boolean
addClassName(element, className):HTMLElement
removeClassName(element, className):HTMLElement
toggleClassName(element, className):HTMLElement
cleanWhitespace(element):HTMLElement,刪除空白文本節(jié)點(diǎn)
empty(element):Boolean,元素是否內(nèi)容為空白
descendantOf(element, ancestor):Boolean,判斷是元素是否為某一元素的子孫,ancestor為id或元素引用。
scrollTo(element):HTMLElement,滾動(dòng)到此元素,并返回此元素的引用。
getStyle(element, style):類型不定,返回元素的某一樣式的值。
getOpacity(element):Float,返回透明度。
setStyle(element, styles):HTMLElement,設(shè)置元素的樣式,styles是一個(gè)JSON對(duì)象。
setOpacity(element, value):HTMLElement,設(shè)置元素的透明度。
getDimensions(element):{width:x,height:y}。返回clientWidth,clientHeight。
makePositioned(element):HTMLElement,將position設(shè)為relative。不把位置設(shè)成當(dāng)前位置的。
undoPositioned(element):HTMLElement,將元素的position設(shè)為默認(rèn)值。
makeClipping(element):HTMLElement,設(shè)置元素的溢出。
undoClipping(element):HTMLElement,清除溢出。
cumulativeOffset(element):Element._returnOffset,獲取相對(duì)整個(gè)頁(yè)面的offset。
positionedOffset(element):Element._returnOffset,獲取相對(duì)于第一個(gè)position不是static的元素offset。如果都是static,則是相對(duì)于頁(yè)面。
absolutize(element):HTMLElement,把position設(shè)成absolute,并把位置設(shè)置成當(dāng)前位置。
relativize(element):HTMLElement,把position設(shè)成ralative,并把位置設(shè)成當(dāng)前位置。
cumulativeScrollOffset(element):Element._returnOffset,相對(duì)于頂層容器的scrollOffset的總和,不一定是文檔哦,因?yàn)轫?yè)面中有iframe就不是了。
getOffsetParent(element):HTMLElement,研究過(guò)css的就好說(shuō),不用多言了。
viewportOffset(element):Element._returnOffset,求相對(duì)于視區(qū)左上角的偏移量。
clonePosition(element, source):HTMLElement,從source克隆位置屬性到自身。
相關(guān)文章
prototype 1.5相關(guān)知識(shí)及他人筆記
prototype 1.5相關(guān)知識(shí)及他人筆記...2006-12-12
Prototype Selector對(duì)象學(xué)習(xí)
這個(gè)對(duì)象在幫助文檔上并沒(méi)有,但是這個(gè)對(duì)象確是整個(gè)DOM操作的核心類,工具函數(shù)$$,其實(shí)就是調(diào)用這個(gè)類的方法2009-07-07
Prototype Array對(duì)象 學(xué)習(xí)
這個(gè)對(duì)象擴(kuò)展了JS原生的Array對(duì)象,提供了一些基本的工具函數(shù),有些方法非常簡(jiǎn)單,源碼里就不在注釋了。2009-07-07
Prototype Hash對(duì)象 學(xué)習(xí)
這個(gè)對(duì)象相當(dāng)于Java中的HashMap,當(dāng)然了功能沒(méi)HashMap那么強(qiáng)大。提供一直基本的方法,簡(jiǎn)單的方法就不在源碼中注釋了。2009-07-07
Prototype String對(duì)象 學(xué)習(xí)
這個(gè)對(duì)象里面的方法就是提供了一些字符串操作的工具方法,比較重要的gsub方法,下面做了詳細(xì)的注釋,簡(jiǎn)單的方法就不說(shuō)了,一看就明白了。2009-07-07
Prototype PeriodicalExecuter對(duì)象 學(xué)習(xí)
這個(gè)對(duì)象就是可以周期性的執(zhí)行某個(gè)方法,但是在它內(nèi)部維持了一個(gè)狀態(tài),可以防止由于某些原因一次調(diào)用沒(méi)執(zhí)行,然后下一次調(diào)用又來(lái)了,這樣會(huì)造成連續(xù)執(zhí)行兩次方法。上面的第二斷英文就是這個(gè)意思。2009-07-07
prototype 1.5 & scriptaculous 1.6.1 學(xué)習(xí)筆記
prototype 1.5 & scriptaculous 1.6.1 學(xué)習(xí)筆記...2006-09-09
Prototype Function對(duì)象 學(xué)習(xí)
這個(gè)對(duì)象就是對(duì)function的一些擴(kuò)充,最重要的當(dāng)屬bind方法,其中wrap方法也很重要,在類繼承機(jī)制里面就是利用wrap方法來(lái)調(diào)用父類的同名方法。2009-07-07

