[转]Jquery.dimensions.js插件Dimensions API

方法:

    * height
     * innerHeight
     * innerWidth
     * offset
     * offsetParent
     * outerHeight
     * outerWidth
     * position
     * scrollLeft
     * scrollTop
     * width

height

     这是对jq核心height方法的扩展,使它既能获取元素的高度,也能获取窗体(windows)和文档(documentobject)的高度.当用在元素上时,通过指定一个数值来设定它的高度.同时它对显示和隐藏的元素都起作用.

    返回值:     像素值


    参数:       数值


     一个整数代表想要设定的高度.如果只是一个数字,方法会为你自动加上'px'.

    可链性(Chainable,jQuery中提到了ChainableMethods的思想,也就是调用jQuery中的方法会返回一个jQuery对象,仍然可以继续调用其中的方法,这样,就形成了一个“链条”,通过“.”一个一个调用下去_)

    此方法可链,只要传递一个数值.

例子::

     $(window).height();

     $(document).height();

     $("#myElement").height();

     $("#myElement").height(100);

innerHeight

     获取第一个匹配元素的内高 (不包含border但包含padding) 对显示和隐藏的元素都起作用.
    
返回:


     像素值

可链性(Chainable)

    不可链


例子:

     $("#myElement").innerHeight();

innerWidth

     获取第一个匹配元素的内宽 (不包含border但包含padding) 对显示和隐藏的元素都起作用.


返回:


    像素值


可链性(Chainable
)

    不可链

例子:

     $("#myElement").innerHeight();

offset

     获取一个元素相对于当前点(viewport)的位置.为确保精确计算,对于margin,border,padding要使用像素单位,此方法对对显示和隐藏的元素都起作用.

返回:
     一个含有top和left属性的对象An object with top and left properties that arenumbers that represent the offset in pixels.当scroll选项为true时,另外两个属性scrollTop和scrollLeft也包含在其中。

参数:
     选项:设置起来配置offset的计算方式。

      margin (布尔值)
           元素的margin是否计算在内。缺省为计算(true)

      border (布尔值)
             元素的border是否计算在内。缺省为不计算(false)

      padding (布尔值)
             元素的padding是否计算在内。缺省为不计算(false)

      scroll (布尔值)
            父元素的scroll offsets 是否计算在内。缺省为计算(true)

      lite (布尔值)

           当为真(true)时,将忽略浏览器的正常值,就像处理当前元素的border和margin一样.这很好的提升了性能,但要牺牲一些精确性.缺省为false.

      ativeTo (HTML元素)

            这应该是元素的一个包含位置设置(比如absolute或relative)的父元素,方法将相对与这个父元素来调整offset.缺省情况是body元素.


     returnObject
        一个存储返回值的对象.目的是不破坏链条.如果在链条中传递,将不回破坏链条而且结果将被赋予这个对象.

可链性:
   

   可链,当一个对象做为地二个参数传递的时候.

例子:

     $("#myElement").offset();

结果:

    { top: 100, left: 100, scrollTop: 10, scrollLeft: 10 }

例子:
     $("#myElement").offset({ scroll: false });

结果:


     { top: 100, left: 100 }

例子:
     
     var offset = {};
     $("#myElement").offset({ scroll: false }, offset);
                        

结果:

     offset == { top: 100, left: 100 }

offsetParent

     返回第一个匹配元素的有定位的父元素的集合.这是元素的第一有定位的父元素这个方法只对可见元素起作用.

返回:

    jQuery 集合


可链性: 可链


例子:

     $("#myElement").offsetParent();

outerHeight

     获取第一个匹配元素的offsetHeight (缺省包含border和padding)这个方法对显示和隐藏的元素都起作用.通过传递map选项的margin为真,可以将margin计算在内.margin可选是在1.1版本中加入的.

返回::像素值

参数::

    选项:
         用来设定outerheights的计算方式。

         margin (布尔值)
            是否元素的margin计算在内。缺省不计算

可链性:不可链


例子:

     $("#myElement").outerHeight();

例子:
     $("#myElement").outerHeight({ margin: true });

outerWidth

     获取第一个匹配元素的offsetWidth (缺声情况是包含border和padding)此方法对显示和隐藏元素都起作用。.通过传递map选项的margin为真,可以将margin计算在内.margin可选是在1.1版本中加入的.

返回::像素值

参数::

    选项:
         用来设定outerheights的计算方式。

         margin (布尔值)
            是否元素的margin计算在内。缺省不计算

可链性:不可链

例子:

     $("#myElement").outerWidth();

例子:

     $("#myElement").outerWidth({ margin: true });

position

     获取一个元素相对于它的offset父元素的上和左的位置。为确保计算精确,对于margin要使用像素单位。此方法只作用于可见元素。

返回:
   

一个包含top,left属性的对象,top,left的数字代表哦offset的像素值。

可链性:
     可链,当一个对象作为第二个参数传递。

例子:

     $("#myElement").position();

结果:

     { top: 10, left: 10 }

例子:
     
     var position = {};
     $("#myElement").position(position);
                        
结果:

     position == { top: 10, left: 10 }

scrollLeft

     起到获取和设置双重作用。但没有数值作为参数时,它获取第一个匹配元素的scroll left offset,当有一个数值作为参数时,所有匹配元素scroll left offset都被设置为这个参数值。方法对可见元素和隐藏元素都起作用。

返回:像素值。

参数:数值

         一个整数,表示想要设置的scroll left offset值。

可链性:     可链,当一个只作为参数时。

例子:

     $("#myElement").scrollLeft(100);

例子:

     $("#myElement").scrollLeft();

结果:

     100

scrollTop

     起到获取和设置双重作用. 但没有数值作为参数时,它获取第一个匹配元素的scroll top offset .当有一个数值作为参数时,所有匹配元素scroll top offset都被设置为这个参数值。. 对显示和隐藏的元素都起作用.

返回:像素值:

     
参数:

       数值

         一个整数代表想要设置的 scroll top offset.

     Chainable:
     可以,当一个参数传递的时候

例子:

     $("#myElement").scrollTop(100);

例子:

     $("#myElement").scrollTop();

结果:

     100

width

       这是对jq核心width方法的扩展,使它既能获取元素的宽度,也能获取窗体(windows)和文档(documentobject)的宽度.当用在元素上时,通过指定一个数值来设定它的宽度.同时它对显示和隐藏的元素都起作用.


返回值:     像素值
参数:       数值


     一个整数代表想要设定的高度.如果只是一个数字,方法会为你自动加上'px'.

    Chainable:

     当然,只要传递一个数值.

例子:

     $(window).width();

     $(document).width();

     $("#myElement").width();

     $("#myElement").width(100);

alarm   作者:NewSea     出处:http://newsea.cnblogs.com/    QQ,MSN:iamnewsea@hotmail.com

  如无特别标记说明,均为NewSea原创,版权私有,翻载必纠。欢迎交流,转载,但要在页面明显位置给出原文连接。谢谢。
原文地址:https://www.cnblogs.com/newsea/p/1680041.html