jQuery 源码解析(二十九) 样式操作模块 尺寸详解
样式操作模块可用于管理DOM元素的样式、坐标和尺寸，本节讲解一下尺寸这一块
jQuery通过样式操作模块里的尺寸相关的API可以很方便的获取一个元素的宽度、高度，而且可以很方便的区分padding、border、 margin等，主要有六个API，如下:
- heihgt(size)、width(size) ;获取第一个匹配元素的高度、宽度，或者通过调用.css(name,value)方法来设置高度、宽度。 size可以是字符串或者数值
- innerHeight()、innerWidth() ;获取匹配元素集合中第一个元素的高度、宽度，包括内容content、内边距padding。
- outerHeight(m)、outerWidth(m) ;获取匹配元素集合中第一个元素的高度、宽度，包括内容content、内边距padding，边框border
举个栗子:
writer by:大沙漠 QQ:22969969
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Document</title>
<script src="http://libs.baidu.com/jquery/1.7.1/jquery.min.js"></script>
</head>
<body>
<style>div {width:80px;height:80px;border:10px solid #cf0;background:#333;margin:20px;padding:5px;color:#fff;}</style>
<div>你好</div>
<button>测试按钮</button>
<script>
console.log('width:',$('div').width()); //输出:80
console.log('innerWidth:',$('div').innerWidth()); //输出:90
console.log('outerWidth:',$('div').outerWidth()); //输出:110
$('button').click(function(){
$('div').height(100)
$('div').width(100)
})
</script>
</body>
</html>
我们定义了一个 div和一个按钮，初始化时分别打印包含div的jquery对象的Width、innerWidth和outerWidth输出结果，控制台输出如下:
渲染如下:
另外我们在按钮上绑定了事件，点击可以设置div的尺寸，点击效果如下:
可以看到，点击按钮后div就变大了，这是因为我们通过width、height设置了参数，修改了它的样式。
源码分析
jQuery对heihgt、width、innerHeight、innerWidth、outerHeight、outerWidth这六个API的实现是通过一个getWH()的工具函数实现的，该函数的定义:getWH(elem,name,extra)，参数如下:
- elem ;要获取高度、宽度的DOM元素
- name ;可选字符串，可以是height、width
- extra ;指示了计算宽度和高度的公式字符串，可选，可以设置为padding、border和margin。
函数源码如下:
var cssWidth = [ "Left", "Right" ],
cssHeight = [ "Top", "Bottom" ];
function getWH( elem, name, extra ) { //一个工具函数，用于获取元素的高度、宽度，为尺寸方法.width()、.height()、.innerWidth()、innerHeight()等提供了基础功能 // Start with offset property
var val = name === "width" ? elem.offsetWidth : elem.offsetHeight, //如果参数name是width则val是elem元素的宽度，否则val是elem元素的高度 其中包含了内容content、内边距padding、边框border,不包含外边距margin。
which = name === "width" ? cssWidth : cssHeight, //如果参数name是width则which等于[ "Left", "Right" ]，否则等于[ "Top", "Bottom" ]
i = 0,
len = which.length; if ( val > 0 ) { //如果元素可见
if ( extra !== "border" ) { //参数不是border的情况下，则根据extra值的不同 选择性的加减边框border、内边距padding、外边距margin。
for ( ; i < len; i++ ) { //遍历width数组，分别加减Leftpadding、Rightpadding等信息
if ( !extra ) { //如果没有传入extra参数，则减去内边距padding。
val -= parseFloat( jQuery.css( elem, "padding" + which[ i ] ) ) || 0;
}
if ( extra === "margin" ) { //如果参数extra是margin,则加上外边距margin
val += parseFloat( jQuery.css( elem, extra + which[ i ] ) ) || 0;
} else { //执行到这里则表示extra等于padding
val -= parseFloat( jQuery.css( elem, "border" + which[ i ] + "Width" ) ) || 0;
}
}
} return val + "px"; //最后返回val 如果参数是border则返回包含了内容content、内边距padding、边框border的高度，宽度。
}
//下面是元素不可见的情况，它会在计算样式或内链样式的基础上，根据参数extra,选择性的加上内边距padding、边框border、外边框margin。有兴趣可以看看
// Fall back to computed then uncomputed css if necessary
val = curCSS( elem, name, name );
if ( val < 0 || val == null ) {
val = elem.style[ name ] || 0;
}
// Normalize "", auto, and prepare for extra
val = parseFloat( val ) || 0; // Add padding, border, margin
if ( extra ) {
for ( ; i < len; i++ ) {
val += parseFloat( jQuery.css( elem, "padding" + which[ i ] ) ) || 0;
if ( extra !== "padding" ) {
val += parseFloat( jQuery.css( elem, "border" + which[ i ] + "Width" ) ) || 0;
}
if ( extra === "margin" ) {
val += parseFloat( jQuery.css( elem, extra + which[ i ] ) ) || 0;
}
}
} return val + "px";
}
我们调用width等jquery实例函数时并不是直接调用这个getWH()工具函数的，该函数函数是挂载到jQuery.cssHooks上的，如下:
jQuery.each(["height", "width"], function( i, name ) {
jQuery.cssHooks[ name ] = { //挂载到jQuery.cssHooks上的
get: function( elem, computed, extra ) {
var val;
if ( computed ) {
if ( elem.offsetWidth !== 0 ) { //如果元素可见
return getWH( elem, name, extra ); //则调用函数getWH(elem,name,extra获取高度、宽度)
} else {
jQuery.swap( elem, cssShow, function() {
val = getWH( elem, name, extra );
});
}
return val;
}
},
set: function( elem, value ) {
if ( rnumpx.test( value ) ) {
// ignore negative width and height values #1599
value = parseFloat( value );
if ( value >= 0 ) {
return value + "px";
}
} else {
return value;
}
}
};
});
当我们调用jQuery.css获取一个元素的宽度或高度时(例如调用$.css(div,'width')时，)就会有限调用这个jqueyr.cssHooks里的信息，jquery.css里对于csshooks的实现如下:
jQuery.extend({
css: function( elem, name, extra ) {
var ret, hooks;
// Make sure that we're working with the right name
name = jQuery.camelCase( name );
hooks = jQuery.cssHooks[ name ]; //hooks指向驼峰式样式名对应的修正对象。
name = jQuery.cssProps[ name ] || name;
// cssFloat needs a special treatment
if ( name === "cssFloat" ) {
name = "float";
}
// If a hook was provided get the computed value from there
if ( hooks && "get" in hooks && (ret = hooks.get( elem, true, extra )) !== undefined ) { //优先调用hooks对象的里的get()修正方法，这里就是上面定义的对于width、height属性的get方法了
return ret;
// Otherwise, if a way to get the computed value exists, use that
} else if ( curCSS ) {
return curCSS( elem, name );
}
},
//...
})
了解了getWH()工具函数和通过jQuery.css()会执行getWH函数后，再来看下heihgt、width、innerHeight、innerWidth、outerHeight、outerWidth这六个API的实现，源码如下:
jQuery.each([ "Height", "Width" ], function( i, name ) { //遍历[ "Height", "Width" ]
var type = name.toLowerCase();
// innerHeight and innerWidth
jQuery.fn[ "inner" + name ] = function() { //在jQuery实例上添加innerHeight()、innerWidth方法
var elem = this[0]; //获取第一个匹配元素
return elem ?
elem.style ?
parseFloat( jQuery.css( elem, type, "padding" ) ) : //如果匹配元素有style属性，则调用方法jQuery.css()获取高度、宽度。第三个参数为padding。
this[ type ]() :
null;
};
// outerHeight and outerWidth
jQuery.fn[ "outer" + name ] = function( margin ) { //在jQuery实例上添加定义outerHeight()、outerWidth()方法。
var elem = this[0]; //获取第一个匹配元素
return elem ?
elem.style ?
parseFloat( jQuery.css( elem, type, margin ? "margin" : "border" ) ) : //如果匹配元素有style属性，则调用方法jQuery.css()方法，如果传入了margin，则把margin也算进去
this[ type ]() :
null;
};
jQuery.fn[ type ] = function( size ) { //在jQuery实例上添加height(size)、width(size)方法
// Get window width or height
var elem = this[0]; //获取第一个匹配元素
if ( !elem ) {
return size == null ? null : this;
}
if ( jQuery.isFunction( size ) ) { //如果size参数是函数，则遍历匹配元素集合，在每个集合上执行该函数，并取其返回值迭代调用方法.height(size)、.width(size)。
return this.each(function( i ) {
var self = jQuery( this );
self[ type ]( size.call( this, i, self[ type ]() ) );
});
}
if ( jQuery.isWindow( elem ) ) { //如果elem是window对象,则分拿回html或body元素的可见高度clientHeight、可见宽度clientWidth。
// Everyone else use document.documentElement or document.body depending on Quirks vs Standards mode
// 3rd condition allows Nokia support, as it supports the docElem prop but not CSS1Compat
var docElemProp = elem.document.documentElement[ "client" + name ],
body = elem.document.body;
return elem.document.compatMode === "CSS1Compat" && docElemProp ||
body && body[ "client" + name ] || docElemProp;
// Get document width or height
} else if ( elem.nodeType === 9 ) { //如果匹配的是documet对象，则读取html元素的clientHeight/Width
// Either scroll[Width/Height] or offset[Width/Height], whichever is greater
return Math.max(
elem.documentElement["client" + name],
elem.body["scroll" + name], elem.documentElement["scroll" + name],
elem.body["offset" + name], elem.documentElement["offset" + name]
);
// Get or set width or height on the element
} else if ( size === undefined ) { //如果未传入size参数
var orig = jQuery.css( elem, type ), //调用jQuery.css()读取第一个匹配元素计算后的高度、宽度。
ret = parseFloat( orig );
return jQuery.isNumeric( ret ) ? ret : orig; //返回结果
// Set the width or height on the element (default to pixels if value is unitless)
} else {
return this.css( type, typeof size === "string" ? size : size + "px" ); //否则调用this.css()设置样式
}
};
});
遍历[ "Height", "Width" ]数组，依次在jQuery.fn上挂载属性，内部是通过jQuery.css()获取width或height，也就是上面所说的工具函数。
jQuery 源码解析(二十九) 样式操作模块 尺寸详解的更多相关文章
- jQuery 源码解析(二十六) 样式操作模块 样式详解
样式操作模块可用于管理DOM元素的样式.坐标和尺寸,本节讲解一下样式相关,样式操作通过jQuery实例的css方法来实现,该方法有很多的执行方法,如下: css(obj) ;参数 ...
- jQuery 源码解析(二十八) 样式操作模块 scrollLeft和scrollTop详解
scrollLeft和scrollTop用于获取/设置滚动条的,如下: scrollLeft(val) ;读取或设置整个页面的水平滚动条距离 scrollTop(val) ;读取或设置整个页面的垂直滚 ...
- jQuery 源码解析(二十五) DOM操作模块 html和text方法的区别
html和text都可以获取和修改DOM节点里的内容,方法如下: html(value) ;获取匹配元素集合中的一个元素的innerHTML内容,或者设置每个元素的innerHTML内容, ...
- jQuery 源码解析(二十四) DOM操作模块 包裹元素 详解
本节说一下DOM操作模块里的包裹元素子模块,该模块可将当前匹配的元素替换指定的DOM元素,有如下方法: wrap(html) ;在每个匹配元素的外层添加一层DOM元素 ...
- Vue.js 源码分析(二十九) 高级应用 transition-group组件 详解
对于过度动画如果要同时渲染整个列表时,可以使用transition-group组件. transition-group组件的props和transition组件类似,不同点是transition-gr ...
- jQuery 源码解析(二十二) DOM操作模块 复制元素 详解
本节说一下DOM操作模块里的复制元素子模块,该模块可以复制一个DOM节点,并且可选择的设置是否复制其数据缓存对象(包含事件信息)和是否深度复制(子孙节点等),API如下: $.clone(elem, ...
- Vue.js 源码分析(二十八) 高级应用 transition组件 详解
transition组件可以给任何元素和组件添加进入/离开过渡,但只能给单个组件实行过渡效果(多个元素可以用transition-group组件,下一节再讲),调用该内置组件时,可以传入如下特性: n ...
- Vue.js 源码分析(二十六) 高级应用 作用域插槽 详解
普通的插槽里面的数据是在父组件里定义的,而作用域插槽里的数据是在子组件定义的. 有时候作用域插槽很有用,比如使用Element-ui表格自定义模板时就用到了作用域插槽,Element-ui定义了每个单 ...
- Vue.js 源码分析(二十四) 高级应用 自定义指令详解
除了核心功能默认内置的指令 (v-model 和 v-show),Vue 也允许注册自定义指令. 官网介绍的比较抽象,显得很高大上,我个人对自定义指令的理解是:当自定义指令作用在一些DOM元素或组件上 ...
随机推荐
- python下使用ElasticSearch
一 什么是 ElasticSearch Elasticsearch 是一个分布式可扩展的实时搜索和分析引擎,一个建立在全文搜索引擎 Apache Lucene(TM) 基础上的搜索引擎.当然 Elas ...
- SpringBoot学习笔记（五）：SpringBoot集成lombok工具、SpringBoot集成Shiro安全框架
SpringBoot集成lombok工具 什么是lombok? 自动生成setget方法,构造函数,打印日志 官网:http://projectlombok.org/features/index. 平 ...
- Linux 的文件和目录管理类命令
文件和目录管理类的命令 目录: cd ~[username] ~:指定用户的家目录 cd -:回到上一次所在的目录 路径: 相对路径中: .:当前目录 ..:父目录 pwd: print workin ...
- PAT甲级——A1007 Maximum Subsequence Sum
Given a sequence of K integers { N1, N2, ..., NK }. A continuous subsequence is defined to ...
- 【转载】unittest总结
本文转载链接:http://www.cnblogs.com/yufeihlf/p/5707929.html unittest单元测试框架不仅可以适用于单元测试,还可以适用WEB自动化测试用例的开发与执 ...
- SpringBoot使用注解方式整合Redis
1.首先导入使用Maven导入jar包 <dependency> <groupId>org.springframework.boot</groupId> <a ...
- SpringMVC处理请求的大致流程是怎么样的
SpringMVC请求处理流程 Spring MVC请求处理架构图: 1.用户首先发送请求到前端控制器Dispatcher Servlet, 2.在doDispath这个方法中会为请求找到对 ...
- python学习笔记4.2_正则表达式
常用正则表达式:http://tool.chinaz.com/regex/ 1.正则表达式:提供了一种在文本中灵活查找或匹配字符串模式的方法.单个表达式通常被称为regex. 2.python的re模 ...
- 关于Server.MapPath和HostingEnvironment.MapPath
最近做的项目需要在Controller里重写一个static的方法,在方法内用常用的Server.MapPath会报一个错误:An object reference is required for t ...
- springBoot 项目 jar/war打包 并运行
一:idea 打jar 包 简述:springboor 项目最好的打包方式就是打成jar ,下边就是简单的过程 1.打开idea工具 ,选着要打开的项目, 然后打开view--> too ...