天天看點

prototype學習筆記(Element篇二)

 轉自: http://tianmoboping.blog.163.com/blog/

這一篇主要是要總論Element的所有函數。

  所有函數的第一個參數都為:element,表示要操作的元素的引用,這是為了方面在Element.extend時,把這些方法加入到DOM對象中去,用的是methodize函數。調用的時候不需要輸入第一個參數了,如:

  var b=$('div1').visible();

  另外,幾乎所有函數都會傳回自身,注意,擴充後的元素的類型為:HTMLElement,之是以這麼做,有一個好處,就是友善連寫代碼,如:

  $('div1').update().insert('這是新插入的内容');

  這樣寫代碼有一個好處,可讀性強,且易于書寫。

  下面是函數介紹:

  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,加入了處理腳本等等功能。它先插入内容,然後再執行content中的腳本。

  replace(element, content):HTMLElement

  替換目前元素。并傳回被替換的元素。

  insert(element, insertions):HTMLElement

  在element的指定位置插入内容,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(當建立的罩為div時,可省略标簽設定)

  attributes:一個JSON對象,用于設定元素的樣式,如:{color:"red",backgroundImage:"url(header.gif)"}

  $('win1').wrap('div1',{color:“#666”});

  $('win1').wrap('span',{font-size:12});

  $('win1').wrap({color:“#666”});

  傳回建立的遮罩的引用。

  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[]

  傳回所有子孫元素結點的數組。等于element.select('*')。

  firstDescendant(element):HTMLElement

  傳回第一個兒子。所有兒子(不包括孫子、曾孫……哦)。

  immediateDescendants(element):HTMLElement[]

  傳回所有兒子(不包括孫子、曾孫……哦)。

  previousSiblings(element):HTMLElement[]

  傳回所有兄長。

  nextSiblings(element):HTMLElement[]

  傳回所有弟弟。

  siblings(element):HTMLElement[]

  傳回所有兄弟,且按“從大到小”(在html中的出現順序)的順序排序。

  match(element, selector):Boolean

  元素是否滿足指定的選擇符

  up(element, expression, index):HTMLElement

  element.ancestors()中,滿足表達式expression的數組中,第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[]

  傳回子孫中,滿足選擇符的元素的數組,多個選擇符之間是并集關系。

  adjacent(element,selector):HTMLElement[]

  傳回所有滿足選擇符的兄弟,不包括自己。

  identify(element):string

  有id的傳回已有id,沒有的則取一個id。并傳回。

  readAttribute(element, name):string

  讀屬性

  writeAttribute(element, name, value):HTMLElement

  寫屬性

  

  =============================================

  上面的函數用于查詢、雜務,下面的函數一般用于擷取、設定各種坐标,在網頁中,一個元素的常用坐标有好幾種,不外如下:

  一、相對于文檔左上角的

  二、相對于視區左上角的

  三、相對于某一個元素的

  縱觀各個架構中的代碼,求取坐标不外是這三種。下面略述一二。

  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,删除空白文本節點

  empty(element):Boolean,元素是否内容為空白

  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,求相對于視區左上角的偏移量。

  clonePosition(element, source):HTMLElement,從source克隆位置屬性到自身。