天天看点

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克隆位置属性到自身。