prototype Element學習筆記(篇二)
更新時間:2008年10月26日 00:40:52 作者:
這一篇主要是要總論Element的所有函數(shù)。
所有函數(shù)的第一個參數(shù)都為:element,表示要操作的元素的引用,這是為了方面在Element.extend時,把這些方法加入到DOM對象中去,用的是methodize函數(shù)。調用的時候不需要輸入第一個參數(shù)了,如:
var b=$('div1').visible();
另外,幾乎所有函數(shù)都會返回自身,注意,擴展后的元素的類型為:HTMLElement,之所以這么做,有一個好處,就是方便連寫代碼,如:
$('div1').update().insert('這是新插入的內(nèi)容');
這樣寫代碼有一個好處,可讀性強,且易于書寫。
下面是函數(shù)介紹:
visible(element):Boolean
元素是否可見(依靠element.style.display)
toggle(element):HTMLElement
元素可見則使之不可見,不可見則使之可見。再返回元素本身的引用。(依靠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
替換當前元素。并返回被替換的元素。
insert(element, insertions):HTMLElement
在element的指定位置插入內(nèi)容,insertions的值如下:
string/number/element,例如:'this is the string to insert!!',默認被插到元素的bottom位置。
{top:xxxxx,bottom:yyyy,before:zzzzz,after:aaaa},例如:{top:'this the content you will insert!'}。
返回值為element。
wrap(element, wrapper, attributes):HTMLElement
在element外面再罩一個元素。通常用于做遮罩。
wrapper:elementId、element、tagName、attrbutes(當創(chuàng)建的罩為div時,可省略標簽設置)
attributes:一個JSON對象,用于設置元素的樣式,如:{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
生成一個表示當前元素的字符串,例如:<div id='xxx' class='xxx'>,它只得兩個屬性,不等于toHTML()。
recursivelyCollect(element, property):HTMLElement[]
不好描述,例如:$('div1').recursivelyCollect('firstchild'),它返回div1中的所有是長子身份的元素。
ancestors(element):HTMLElement[]
返回此元素的所有嫡系祖先,例如:如果有元素div1,它的父親是div2,div2的,父親是div3,就是這樣一直調用下去。
descendants(element):HTMLElement[]
返回所有子孫元素結點的數(shù)組。等于element.select('*')。
firstDescendant(element):HTMLElement
返回第一個兒子。所有兒子(不包括孫子、曾孫……哦)。
immediateDescendants(element):HTMLElement[]
返回所有兒子(不包括孫子、曾孫……哦)。
previousSiblings(element):HTMLElement[]
返回所有兄長。
nextSiblings(element):HTMLElement[]
返回所有弟弟。
siblings(element):HTMLElement[]
返回所有兄弟,且按“從大到小”(在html中的出現(xiàn)順序)的順序排序。
match(element, selector):Boolean
元素是否滿足指定的選擇符
up(element, expression, index):HTMLElement
element.ancestors()中,滿足表達式expression的數(shù)組中,第index個元素,示例如下:
$('div1').up('div',1)返回直接祖先中,標簽為div的,且序號為1的元素的引用。
down(element, expression, index):HTMLElement
返回子孫中,第index個滿足選擇符expression的元素。
previous(element, expression, index):HTMLElement
previous(element, expression, index):HTMLElement
這兩個沒懸念,返回前一個、后一個,前n個、后n個。
select(element,selector1,selector2,……):HTMLElement[]
返回子孫中,滿足選擇符的元素的數(shù)組,多個選擇符之間是并集關系。
adjacent(element,selector):HTMLElement[]
返回所有滿足選擇符的兄弟,不包括自己。
identify(element):string
有id的返回已有id,沒有的則取一個id。并返回。
readAttribute(element, name):string
讀屬性
writeAttribute(element, name, value):HTMLElement
寫屬性
=============================================
上面的函數(shù)用于查詢、雜務,下面的函數(shù)一般用于獲取、設置各種坐標,在網(wǎng)頁中,一個元素的常用坐標有好幾種,不外如下:
一、相對于文檔左上角的
二、相對于視區(qū)左上角的
三、相對于某一個元素的
縱觀各個框架中的代碼,求取坐標不外是這三種。下面略述一二。
getHeight(element)、getWidth(element),相當于求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é)點
empty(element):Boolean,元素是否內(nèi)容為空白
descendantOf(element, ancestor):Boolean,判斷是元素是否為某一元素的子孫,ancestor為id或元素引用。
scrollTo(element):HTMLElement,滾動到此元素,并返回此元素的引用。
getStyle(element, style):類型不定,返回元素的某一樣式的值。
getOpacity(element):Float,返回透明度。
setStyle(element, styles):HTMLElement,設置元素的樣式,styles是一個JSON對象。
setOpacity(element, value):HTMLElement,設置元素的透明度。
getDimensions(element):{width:x,height:y}。返回clientWidth,clientHeight。
makePositioned(element):HTMLElement,將position設為relative。不把位置設成當前位置的。
undoPositioned(element):HTMLElement,將元素的position設為默認值。
makeClipping(element):HTMLElement,設置元素的溢出。
undoClipping(element):HTMLElement,清除溢出。
cumulativeOffset(element):Element._returnOffset,獲取相對整個頁面的offset。
positionedOffset(element):Element._returnOffset,獲取相對于第一個position不是static的元素offset。如果都是static,則是相對于頁面。
absolutize(element):HTMLElement,把position設成absolute,并把位置設置成當前位置。
relativize(element):HTMLElement,把position設成ralative,并把位置設成當前位置。
cumulativeScrollOffset(element):Element._returnOffset,相對于頂層容器的scrollOffset的總和,不一定是文檔哦,因為頁面中有iframe就不是了。
getOffsetParent(element):HTMLElement,研究過css的就好說,不用多言了。
viewportOffset(element):Element._returnOffset,求相對于視區(qū)左上角的偏移量。
clonePosition(element, source):HTMLElement,從source克隆位置屬性到自身。
var b=$('div1').visible();
另外,幾乎所有函數(shù)都會返回自身,注意,擴展后的元素的類型為:HTMLElement,之所以這么做,有一個好處,就是方便連寫代碼,如:
$('div1').update().insert('這是新插入的內(nèi)容');
這樣寫代碼有一個好處,可讀性強,且易于書寫。
下面是函數(shù)介紹:
visible(element):Boolean
元素是否可見(依靠element.style.display)
toggle(element):HTMLElement
元素可見則使之不可見,不可見則使之可見。再返回元素本身的引用。(依靠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
替換當前元素。并返回被替換的元素。
insert(element, insertions):HTMLElement
在element的指定位置插入內(nèi)容,insertions的值如下:
string/number/element,例如:'this is the string to insert!!',默認被插到元素的bottom位置。
{top:xxxxx,bottom:yyyy,before:zzzzz,after:aaaa},例如:{top:'this the content you will insert!'}。
返回值為element。
wrap(element, wrapper, attributes):HTMLElement
在element外面再罩一個元素。通常用于做遮罩。
wrapper:elementId、element、tagName、attrbutes(當創(chuàng)建的罩為div時,可省略標簽設置)
attributes:一個JSON對象,用于設置元素的樣式,如:{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
生成一個表示當前元素的字符串,例如:<div id='xxx' class='xxx'>,它只得兩個屬性,不等于toHTML()。
recursivelyCollect(element, property):HTMLElement[]
不好描述,例如:$('div1').recursivelyCollect('firstchild'),它返回div1中的所有是長子身份的元素。
ancestors(element):HTMLElement[]
返回此元素的所有嫡系祖先,例如:如果有元素div1,它的父親是div2,div2的,父親是div3,就是這樣一直調用下去。
descendants(element):HTMLElement[]
返回所有子孫元素結點的數(shù)組。等于element.select('*')。
firstDescendant(element):HTMLElement
返回第一個兒子。所有兒子(不包括孫子、曾孫……哦)。
immediateDescendants(element):HTMLElement[]
返回所有兒子(不包括孫子、曾孫……哦)。
previousSiblings(element):HTMLElement[]
返回所有兄長。
nextSiblings(element):HTMLElement[]
返回所有弟弟。
siblings(element):HTMLElement[]
返回所有兄弟,且按“從大到小”(在html中的出現(xiàn)順序)的順序排序。
match(element, selector):Boolean
元素是否滿足指定的選擇符
up(element, expression, index):HTMLElement
element.ancestors()中,滿足表達式expression的數(shù)組中,第index個元素,示例如下:
$('div1').up('div',1)返回直接祖先中,標簽為div的,且序號為1的元素的引用。
down(element, expression, index):HTMLElement
返回子孫中,第index個滿足選擇符expression的元素。
previous(element, expression, index):HTMLElement
previous(element, expression, index):HTMLElement
這兩個沒懸念,返回前一個、后一個,前n個、后n個。
select(element,selector1,selector2,……):HTMLElement[]
返回子孫中,滿足選擇符的元素的數(shù)組,多個選擇符之間是并集關系。
adjacent(element,selector):HTMLElement[]
返回所有滿足選擇符的兄弟,不包括自己。
identify(element):string
有id的返回已有id,沒有的則取一個id。并返回。
readAttribute(element, name):string
讀屬性
writeAttribute(element, name, value):HTMLElement
寫屬性
=============================================
上面的函數(shù)用于查詢、雜務,下面的函數(shù)一般用于獲取、設置各種坐標,在網(wǎng)頁中,一個元素的常用坐標有好幾種,不外如下:
一、相對于文檔左上角的
二、相對于視區(qū)左上角的
三、相對于某一個元素的
縱觀各個框架中的代碼,求取坐標不外是這三種。下面略述一二。
getHeight(element)、getWidth(element),相當于求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é)點
empty(element):Boolean,元素是否內(nèi)容為空白
descendantOf(element, ancestor):Boolean,判斷是元素是否為某一元素的子孫,ancestor為id或元素引用。
scrollTo(element):HTMLElement,滾動到此元素,并返回此元素的引用。
getStyle(element, style):類型不定,返回元素的某一樣式的值。
getOpacity(element):Float,返回透明度。
setStyle(element, styles):HTMLElement,設置元素的樣式,styles是一個JSON對象。
setOpacity(element, value):HTMLElement,設置元素的透明度。
getDimensions(element):{width:x,height:y}。返回clientWidth,clientHeight。
makePositioned(element):HTMLElement,將position設為relative。不把位置設成當前位置的。
undoPositioned(element):HTMLElement,將元素的position設為默認值。
makeClipping(element):HTMLElement,設置元素的溢出。
undoClipping(element):HTMLElement,清除溢出。
cumulativeOffset(element):Element._returnOffset,獲取相對整個頁面的offset。
positionedOffset(element):Element._returnOffset,獲取相對于第一個position不是static的元素offset。如果都是static,則是相對于頁面。
absolutize(element):HTMLElement,把position設成absolute,并把位置設置成當前位置。
relativize(element):HTMLElement,把position設成ralative,并把位置設成當前位置。
cumulativeScrollOffset(element):Element._returnOffset,相對于頂層容器的scrollOffset的總和,不一定是文檔哦,因為頁面中有iframe就不是了。
getOffsetParent(element):HTMLElement,研究過css的就好說,不用多言了。
viewportOffset(element):Element._returnOffset,求相對于視區(qū)左上角的偏移量。
clonePosition(element, source):HTMLElement,從source克隆位置屬性到自身。
相關文章
javascript prototype,executing,context,closure
JavaScript是一種靈活的腳本語言。與Java、C++等需要編譯執(zhí)行的程序設計語言有很大不同,在使用的過程中,會暴露出一些問題。2008-12-12prototype 1.5 & scriptaculous 1.6.1 學習筆記
prototype 1.5 & scriptaculous 1.6.1 學習筆記...2006-09-09初學prototype,發(fā)個JS接受URL參數(shù)的代碼
初學prototype,發(fā)個JS接受URL參數(shù)的代碼...2006-09-09滾動經(jīng)典最新話題[prototype框架]下編寫
滾動經(jīng)典最新話題[prototype框架]下編寫...2006-10-10prototype Element學習筆記(Element篇三)
上一篇把Element的所函數(shù)都梳理了一遍,下面總結一下這些函數(shù)的功能,畢竟函數(shù)太多,不分門別類一下還是沒有底。2008-10-10