jQuery.support
jQuery.support 用于检查浏览器对各项特性的支持。检查项多达 27 个。
首先,让我们用一段代码测试一下 support 中包含的检查项:
<script src='jquery.js'></script> <script> support = $.support; for (key in support) { document.write('support.' + key + ' = ' + support[key] + '<br />'); } </script>
IE 下的输出结果为:
support.leadingWhitespace = false support.tbody = false support.htmlSerialize = false support.style = false support.hrefNormalized = false support.opacity = false support.cssFloat = false support.checkOn = true support.optSelected = false support.getSetAttribute = false support.submitBubbles = false support.changeBubbles = false support.focusinBubbles = true support.deleteExpando = false support.noCloneEvent = false support.inlineBlockNeedsLayout = false support.shrinkWrapBlocks = true support.reliableMarginRight = true support.noCloneChecked = false support.optDisabled = true support.radioValue = false support.checkClone = undefined support.appendChecked = false support.boxModel = false support.reliableHiddenOffsets = false support.ajax = true support.cors = false
FireFox 中的显示结果为:
support.leadingWhitespace = true support.tbody = true support.htmlSerialize = true support.style = true support.hrefNormalized = true support.opacity = true support.cssFloat = true support.checkOn = true support.optSelected = true support.getSetAttribute = true support.submitBubbles = true support.changeBubbles = true support.focusinBubbles = false support.deleteExpando = true support.noCloneEvent = true support.inlineBlockNeedsLayout = false support.shrinkWrapBlocks = false support.reliableMarginRight = true support.noCloneChecked = true support.optDisabled = true support.radioValue = true support.checkClone = undefined support.appendChecked = true support.boxModel = true support.reliableHiddenOffsets = true support.ajax = true support.cors = true
需要注意的是,源代码中 checkClone 的检查是有问题的。这将在后面提到。
接下来,我们就对这些检查项进行逐一的分析。
leadingWhitespace
检查用 innerHTML 赋值时,是否会保留前面的空白符。
IE中为 false , Firefox 中为 true 。
实现方式如下:
$ = function(){ var div = document.createElement( "div" ); div.innerHTML = " <link/><table></table><a href='/a' style='top:1px;float:left;opacity:.55;'>a</a><input type='checkbox'/>"; var support = { leadingWhitespace: (div.firstChild.nodeType === 3) } return { support : support } }();
这段代码中,先创建了一个 div ,之后就用 innerHTML 为 div 赋值,
然后检查 div 的第一个子元素的 nodeType 是否为 3 (表示文本),
是的话则空白字符被保留,否则未被保留。
tbody
检查是否会自动为 table 插入 tbody ,会的话为 false ,不会则为 true 。
IE中为 false , FireFox 中为 true 。
实现方式如下:
$ = function(){ // Other codes ... var support = { leadingWhitespace: (div.firstChild.nodeType === 3), tbody: !div.getElementsByTagName("tbody").length } // Other codes ... }();
这段代码在原有基础上为 support 增加了 tbody 属性, 并检查是否能够获取 tbody 标签。
由于 innerHTML 中已经包含了 table 标签,能获取 tbody 标签的话则表示会自动为 table 插入 tbody,否则表示不会自动插入 tbody 。
htmlSerialize
检查link标签能否被正确地序列化。
IE中为 false , FireFox 中为true 。
实现方式如下:
$ = function(){ // Other codes ... var a = div.getElementsByTagName("a")[0]; var support = { // Other codes ... tbody: !div.getElementsByTagName( "tbody" ).length, htmlSerialize: !!div.getElementsByTagName("link").length } return { support : support } }();
这段代码在原有基础上为 support 增加了 htmlSerialize 属性,并检查能否获取 link 标签。
由于 innerHTML 中已经包含了 link 标签,能通过getElementsByTagName 获取 link 标签的话,表示 link 可以被正确地序列化,否则表示 link 标签不能被正确地序列化。
style
检查是否能通过 “style” 属性获取 DOM Element 的样式。
IE中为 false , Firefox 中为 true 。
实现方式如下:
$ = function(){ // Other codes ... var a = div.getElementsByTagName("a")[0]; var support = { // Other codes ... htmlSerialize: !!div.getElementsByTagName("link").length, style: /top/.test(a.getAttribute("style")) } return { support : support } }();
这段代码先是通过 getElementsByTagName("a") 获取表示链接的 DOM Element,
然后在原有基础上为 support 增加了 style 属性,并检查能否通过 getAttribute("style") 获取样式。
hrefNormalized
检查链接的 “href” 属性能否被正常地序列化。
IE中为 false , FireFox 中为 true 。
实现方式如下:
$ = function(){ // Other codes ... var support = { // Other codes ... style: /top/.test(a.getAttribute("style")), hrefNormalized: (a.getAttribute("href") === "/a") } return { support : support } }();
这段代码通过 getAttribute("href") 来获取 “href” 属性的值,
能正确获取则表示链接的 “href”属性能够被正确地序列化。
opacity
检查 css 样式中的透明度设置能够被有效支持。
IE 中为 false , FireFox 中为 true 。
实现方式如下:
$ = function(){ // Other codes ... var support = { // Other codes ... hrefNormalized: (a.getAttribute("href") === "/a"), opacity: /^0.55$/.test(a.style.opacity) } return { support : support } }();
这段代码通过 a.style.opacity 来获取透明度设置,并用正则表达式 /^0.55$/ 进行检查,通过检查表示 css 样式中的透明度能够被有效地支持,否则表示不能。
cssFloat
检查 css 样式中的 float 属性能够被有效支持。
IE 中为 false , FireFox中为 true 。
实现方式如下:
$ = function(){ // Other codes ... var support = { // Other codes ... opacity: /^0.55$/.test(a.style.opacity), cssFloat: !!a.style.cssFloat } return { support : support } }();
这段代码通过 a.style.cssFloat 来获取 float 属性,并通过 !! 将属性转为 boolean 值(undefined 将被转为 false ,而其他值将被转为 true)。
checkOn
检查 chebox 的 value 是否为 “on”。
IE 和 FireFox 中都为true,而 Chrome 中则为 false 。
实现方式如下:
$ = function(){ // Other codes ... var a = div.getElementsByTagName("a")[0], input = div.getElementsByTagName("input")[0]; var support = { // Other codes ... cssFloat: !!a.style.cssFloat, checkOn: (input.value === "on") } return { support : support } }();
这段代码先通过 getElementsByTagName("input") 获取 checkbox,然后检查 checkbox 的 value 是否为 “on”。
optSelected
检查 select 中的第一个 option 能否被默认选中。
IE 中为 false , FireFox 中为 true 。
$ = function(){ // Other codes ... var select = document.createElement("select"); var opt = select.appendChild(document.createElement("option")); var support = { // Other codes ... checkOn: (input.value === "on"), optSelected: opt.selected } return { support : support } }();
这段代码先通过 createElement("select") 创建了一个 select,
然后将一个 “option” 添加到了 select 中。
接着在 support 中增加了属性 optSelected,检查 opt.selected 是否为true 。
getSetAttribute
检查能够功过 getAttribute("calssName") 和 setAttribute("className", "...") 来获取和设置 div 的 css class。
实际上只检查 setAttribute("className", "...")。
IE 中为 false , FireFox 中为 true 。
$ = function(){ // Other codes ... div.setAttribute("className", "t"); var support = { // Other codes ... optSelected: opt.selected, getSetAttribute: div.className !== "t" } return { support : support } }();
这段代码通过 div.setAttribute("classsName", "t") 将 div 的 css class 设置为 “t”,然后在 support 中增加 getSetAttribute 属性, 检查 div 的 className 是否为 “t”。
submitBubbles, changeBubbles, focusinBubbles
检查 submit、change、focus 事件是否在“冒泡阶段”触发。实际上只针对 IE 进行检查。因为大多数浏览器(及IE9)使用 addEventListener 附加事件,函数的第三个参数 useCapture (是否在“捕捉阶段”触发事件)既可以为 false ,也可以为 true 。
而 IE (IE9之前)使用 attachEvent 函数附加事件,该函数无法指定在哪个阶段触发事件,一律都为“冒泡阶段”触发。
关于 Bubble Event 的更多内容,可以参考 iteye 里其他相关的文章:
http://www.iteye.com/search?query=bubble+event&type=blog
实现方式如下:
$ = function(){ // Other codes ... var support = { // Other codes ... getSetAttribute: div.className !== "t", submitBubbles: true, changeBubbles: true, focusinBubbles: false } if (div.attachEvent) { for(var i in { submit: 1, change: 1, focusin: 1 }) { var eventName = "on" + i; var isSupported = (eventName in div); if (!isSupported) { div.setAttribute(eventName, "return;"); isSupported = ( typeof div[eventName] === "function" ); } support[i + "Bubbles"] = isSupported; } } return { support : support } }();
首先,在 support 中增加 submitBubbles, changeBubbles, focusinBubbles,默认值分别为 true, true, false ,这是针对大多数浏览器的。
然后,针对IE (也就是存在 DOMElement.attachEvent 函数的情况),检查 "onXXX" 事件是否存在,以及能否通过 setAttribute(eventName, xxx)进行设置,可以的话就判断为“冒泡阶段”触发(即只要支持该事件,就判断为“冒泡阶段”触发)。
事实上,jQuery 中的 focusin 事件是在 focus 的基础上进行模拟的,浏览器并不支持该事件,所以 focusinBubbles 总是为 false。
从源代码中的注释来看,似乎还考虑到了跨站脚本攻击:
Short-circuiting here helps us to avoid an eval call (in setAttribute) which can cause CSP to go haywire.
大意是说在这里进行简短的检查(typeof div[eventName] === "function"),而不是直接用 eval 执行事件,可以避免不可控的跨站脚本攻击。(我不确定有没有翻译错)
deleteExpando
检查是否允许删除附加在 DOM Element 上的数据。
IE 中为 false , FireFox 中为 true 。
实现方式如下:
$ = function(){ // Other codes ... var support = { // Other codes ... focusinBubbles: false, deleteExpando: true } // Other codes ... try { delete div.test; } catch(e) { support.deleteExpando = false; } return { support : support } }();
首先在 support 中增加属性 deleteExpando ,默认值为 true 。
然后尝试删除 div.test ,发生错误则将 deleteExpando 设为 false 。
noCloneEvent
检查复制 DOM Element 时是否会连同 event 一起复制,会则为 false , 不会则为true 。
IE 中为 false , FireFox 中为 true 。
实现方式如下:
$ = function(){ // Other codes ... var support = { // Other codes ... deleteExpando: true, noCloneEvent: true } // Other codes ... if (!div.addEventListener && div.attachEvent && div.fireEvent) { div.attachEvent( "onclick", function click() { support.noCloneEvent = false; div.detachEvent( "onclick", click ); }); div.cloneNode(true).fireEvent("onclick"); } return { support : support } }();
首先在 support 中增加属性 noCloneEvent , 默认值为 true 。
然后复制 div, 并触发其 “onclick” 事件,触发成功则为将 noCloneEvent 设为 false。
从判断条件来看,依旧是针对 IE 的事件体系的检查。
inlineBlockNeedsLayout, shrinkWrapBlocks
都是针对 offsetWidth 的检查。
inlineBlockNeedsLayout 表示将原本 display 为 block 的 DOM Element 设置为 disylay: inline 时,是否与 inline 形式的 DOM Elemnt 一致( offsetWidth 为 2 )。
IE 8 及之前的浏览器中为 true , FireFox 中为 false 。
shrinkWrapBlocks 表示内部 DOM Element 的样式是否会影响外部 DOM Element 的样式。
IE 6 中为 true , 多数浏览器中为 false 。
实现方式如下:
$ = function(){ // Other codes ... var support = { // Other codes ... noCloneEvent: true, inlineBlockNeedsLayout: false, shrinkWrapBlocks: false } // Other codes ... if ( "zoom" in div.style ) { div.style.display = "inline"; div.style.zoom = 1; support.inlineBlockNeedsLayout = ( div.offsetWidth === 2 ); div.style.display = ""; div.innerHTML = "<div style='width:4px;'></div>"; support.shrinkWrapBlocks = ( div.offsetWidth !== 2 ); } return { support : support } }();
首先在 support 中增加这两个属性,然后将 div 的 css 样式中的 display 设为 inline ,并检查 offsetWidth ,以确定 inlineBlockNeedsLayout 的值。
接着在 div 内部增加一个 div, 并将其宽度设为 4px ,并检查 offsetWith 的值,以确定外部的 div 是否会受到影响而收缩。
reliableMarginRight
检查 Margin Right 的计算是否可靠。 各浏览器中都为 true 。
原注释中提到某些老版本的 Webkit 内核的浏览器中为 false 。
实现方式如下:
$ = function(){ // Other codes ... var support = { // Other codes ... shrinkWrapBlocks: false, reliableMarginRight: true } // Other codes ... if ( document.defaultView && document.defaultView.getComputedStyle ) { var marginDiv = document.createElement( "div" ); marginDiv.style.width = "0"; marginDiv.style.marginRight = "0"; div.appendChild( marginDiv ); support.reliableMarginRight = ( parseInt( document.defaultView.getComputedStyle( marginDiv, null ).marginRight, 10 ) || 0 ) === 0; } return { support : support } }();
简单地说,就是将 width 和 marginRight 设为 0 时,获取的 marginRignt 应为 0 。
noCloneChecked
检查复制 checkbox 时是否连选中状态也一同复制,若复制则为 false ,否则为 true 。
实现方式如下:
$ = function(){ // Other codes ... input.checked = true; support.noCloneChecked = input.cloneNode(true).checked; return { support : support } }();
这段代码将 input 的选中状态设为 true ,然后复制 input ,并检查 checked 是否为 true 。
optDisabled
已经被设为 disable 的 select ,其内部的 option 的 disable 不应为 true 。
这个名称有一定的误导性,可能称为 “optNotDisabled” 更合适一些。
在各浏览器上的值都为 true 。
根据原注释,某些老版本的 Webkit 内核的浏览器上,该值为 false 。
实现如下:
$ = function(){ // Other codes ... select.disabled = true; support.optDisabled = !opt.disabled; return { support : support } }();
这段代码先将 select 的状态设为 disable , 然后检查其中的 option 的 disable 的值。
radioValue
检查 input 元素被设为 radio 类型后是否仍然保持原来的值。
IE 中为 false , FireFox 中为 true 。
实现方式如下:
$ = function(){ // Other codes ... input = document.createElement("input"); input.value = "t"; input.setAttribute("type", "radio"); support.radioValue = input.value === "t"; return { support : support } }();
这段代码先创建了 input 元素,将 value 设为 “t” ,然后将其类型设置为 “radio”,最后检查器 input 原来的值是否仍然保留。
checkClone
检查 fragment 中的 checkbox 的选中状态是否能被复制,IE 中为 false ,FireFox 中为 true 。
实现方式如下:
$ = function(){ // Other codes ... div.innerHTML = ""; input.setAttribute("checked", "checked"); div.appendChild( input ); fragment = document.createDocumentFragment(); fragment.appendChild( div.firstChild ); support.checkClone = fragment.cloneNode(true).cloneNode(true).lastChild.checked; return { support : support } }();
这段代码创建了一个 fragment ,并将一个处于选中状态的 checkbox 加入,连续复制两遍后检查 checkbox 是否为选中状态。(这里源代码中的实现似乎有问题,没有将 div 的 innerHTML 清空,导致 div 的 firstChild 并非 checkbox,使得 checkclone 在各浏览器中的值均为 undefined 。)
appendChecked
检查被添加到 DOM 中的 checkbox 是否仍然保留原来的选中状态。
IE 中为 false ,FireFox 中为 true 。
实现方式如下:
$ = function(){ // Other codes ... support.appendChecked = input.checked; return { support : support } }();
实际上只是简单地检查之前添加到 fragment 中的 checkbox 的选中状态。
boxModel
检查页面渲染是否符合 W3C Box Model 。
在 IE 中没有 DocType 声明时为 false ,其余情况为 true 。
实现方式如下:
$ = function(){ // Other codes ... div.innerHTML = ""; div.style.width = div.style.paddingLeft = "1px"; body = document.createElement( "body" ); bodyStyle = { visibility: "hidden", width: 0, height: 0, border: 0, margin: 0, background: "none" }; for (var i in bodyStyle ) { body.style[i] = bodyStyle[i]; } body.appendChild(div); document.documentElement.appendChild(body); support.boxModel = div.offsetWidth === 2; body.innerHTML = ""; document.documentElement.removeChild( body ); return { support : support } }();
将 div 的 width 和 paddingLeft 设为 1px ,然后将它添加到 body 中,检查 div 的 offsetWidth 是否为 2 。
reliableHiddenOffsets
检查 hidden 状态下的 offsetWidth 和 offsetHeight 是否正确。
IE 中为 false , FireFox 中为 true 。
实现方式如下(插入到清空 body.innerHTML 之前):
$ = function(){ // Other codes ... div.innerHTML = "<table><tr><td style='padding:0;border:0;display:none'></td><td>t</td></tr></table>"; var tds = div.getElementsByTagName("td"); var isSupported = (tds[0].offsetHeight === 0); tds[0].style.display = ""; tds[1].style.display = "none"; support.reliableHiddenOffsets = isSupported && (tds[0].offsetHeight === 0); body.innerHTML = ""; document.documentElement.removeChild( body ); return { support : support } }();
检查将一个 td 隐藏时, 相邻的 td 的 offsetHeight 是否为 0 。
ajax, cors
检查是否支持 ajax 请求,以及是否支持跨域 ajax。
IE 与 FireFox 中 ajax 均为 true ,IE 中 cors 为 false , FireFox 中 cros 为 false 。
实现方式如下:
$ = function(){ // Other codes ... var xhr = window.ActiveXObject ? !this.isLocal && createStandardXHR() || createActiveXHR() : createStandardXHR(); support.ajax = !!xhr; support.cors = !!xhr && ( "withCredentials" in xhr ) function createStandardXHR() { try { return new window.XMLHttpRequest(); } catch( e ) {} } function createActiveXHR() { try { return new window.ActiveXObject("Microsoft.XMLHTTP"); } catch( e ) {} } return { support : support } }();
尝试创建 ajax 对象,创建成功,则 ajax 为 true ;如果 ajax 对象中包含了 "withCredentials" 属性,则表示支持跨域 ajax。