jQuery support 源码解读

jquery support主要是检测浏览器兼容性，支持力度的方法，用于展示不同浏览器各自特性和bug的属性集合。作为一个静态成员，提供给jquery内部函数，告诉他们某些功能是否能用。避免了以往通过检测浏览器版本做修改。
　　可以直接调用jQuery.support来检测某些功能，通过查看其源代码我们可以更深入的了解各个浏览器之间的区别。特别是针对IE，还有webkit的bug，都能让我们受益匪浅。

　

兼容各种主流浏览器是JavaScript库的必修课之一，一般来说检测浏览器有两种方法：

1. 检测navigator.userAgent，用户代理检测法
2. 检测浏览器的功能特性，即功能特性检测法

而jQuery1.3开始采用的就是功能特性检测法，以下是针对最新的jquery1.9.1版本，添加的注释。

// 浏览器各自特性和bug的属性集合，功能特性检测/支持
jQuery.support = (function () {
    // 声明变量
    var support, all, a,
        input, select, fragment,
        opt, eventName, isSupported, i,
        div = document.createElement("div");

    // Setup
    // 设置class样式
    div.setAttribute("className", "t");
    // 插入HTML
    div.innerHTML = "  <link/><table></table><a href='/a'>a</a><input type='checkbox'/>";

    // Support tests won't run in some limited or non-browser environments
    // 获取元素
    all = div.getElementsByTagName("*");
    a = div.getElementsByTagName("a")[0];

    // 检测是否支持最基本检测
    if (!all || !a || !all.length) {
        return {};
    }

    // First batch of tests
    // 创建select元素
    select = document.createElement("select");

    // 创建option元素并插入到select中
    opt = select.appendChild(document.createElement("option"));

    // 获取input元素
    input = div.getElementsByTagName("input")[0];

    // 设置CSS样式
    // cssText：设置样式
    // 说明：在IE中最后一个分号会被删掉,可以添加一个分号来解决这个问题
    // 例如: Element.style.cssText += ’;width:100px;height:100px;top:100px;left:100px;’
    a.style.cssText = "top:1px;float:left;opacity:.5";

    // support（支持）对象
    support = {
        // Test setAttribute on camelCase class. If it works, we need attrFixes when doing get/setAttribute (ie6/7)
        // 验证一些属性是否支持使用get/setAttribute方法，不支持返回true，支持返回false
        // 通过setAttribute添加class值是否成功来检测,IE6~7支持，其他浏览器不支持
        getSetAttribute:div.className !== "t",

        // IE strips leading whitespace when .innerHTML is used
        // 检测节点类型是否为文本节点 成功返回true，失败返回false
        // 使用innerHTML，IE会自动剔除HTML代码头部的空白符
        leadingWhitespace:div.firstChild.nodeType === 3,

        // Make sure that tbody elements aren't automatically inserted
        // IE will insert them into empty tables
        // 验证是否存在tbody标签，不存在返回true，存在返回false
        // 确保tbody元素不会自动插入（IE6~7会自动插入的空tbody）
        tbody:!div.getElementsByTagName("tbody").length,

        // Make sure that link elements get serialized correctly by innerHTML
        // This requires a wrapper element in IE
        // 验证innerHTML插入链接元素是否可被序列化，成功则返回true，失败返回false
        // 所谓序列化是指：可被读取的一种存储标准，在IE6~8中返回false。
        htmlSerialize:!!div.getElementsByTagName("link").length,

        // Get the style information from getAttribute
        // (IE uses .cssText instead)
        // 验证getAttribute("style")是否返回元素的行内样式，成功返回true,失败返回false
        // 在IE6~8中为false，因为他用cssText代替
        style:/top/.test(a.getAttribute("style")),

        // Make sure that URLs aren't manipulated
        // (IE normalizes it by default)
        // 验证getAttribute("href")返回值是否原封不动，成功返回true，失败返回false
        // 在IE6~7中会返回false，因为他的URL已常规化。
        hrefNormalized:a.getAttribute("href") === "/a",

        // Make sure that element opacity exists
        // (IE uses filter instead)
        // Use a regex to work around a WebKit issue. See #5145
        // 验证浏览器是否能正确解析opacity,成功返回true,失败返回false
        // 在IE6~8中返回false，因为他用alpha滤镜代替。
        opacity:/^0.5/.test(a.style.opacity),

        // Verify style float existence
        // (IE uses styleFloat instead of cssFloat)
        // 验证cssFloat是否存在，成功返回true，失败返回false
        // 在IE6~8中返回false,他用styleFloat代替
        cssFloat:!!a.style.cssFloat,

        // Check the default checkbox/radio value ("" on WebKit; "on" elsewhere)
        // 验证checkbox的默认value是否为'on',成功返回true,失败返回false
        // safair默认为'' 空字符串
        checkOn:!!input.value,

        // Make sure that a selected-by-default option has a working selected property.
        // (WebKit defaults to false instead of true, IE too, if it's in an optgroup)
        // 验证创建的select元素的第一个option元素是否会默认选中, 成功返回true，失败返回false
        // FF，Chrome返回true,IE6~10返回false
        // 注意:option元素的父元素不一定是select，也有可能是optgroup
        optSelected:opt.selected,

        // Tests for enctype support on a form (#6743)
        // 验证创建form的enctype属性是否存在，存在返回true，不存在返回fasle(IE6~9,均存在)
        // enctype:设置表单的MIME编码,默认编码格式是application/x-www-form-urlencoded,不能用于文件上传；multipart/form-data，才能完整的传递文件数据
        enctype:!!document.createElement("form").enctype,

        // Makes sure cloning an html5 element does not cause problems
        // Where outerHTML is undefined, this still works
        // 验证是否支持html5节点复制，成功返回ture，失败返回false
        // 失败：复制节点cloneNode(true).innerHTML返回一个空字符串
        html5Clone:document.createElement("nav").cloneNode(true).outerHTML !== "<:nav></:nav>",

        // jQuery.support.boxModel DEPRECATED in 1.8 since we don't support Quirks Mode
        // 验证页面和浏览器是否以W3C CSS盒式模型来渲染，而非怪异模式下。IE6~7的怪癖模式会返回false
        boxModel:document.compatMode === "CSS1Compat",

        // Will be defined later
        // 稍后将定义
        deleteExpando:true,
        noCloneEvent:true,
        inlineBlockNeedsLayout:false,
        shrinkWrapBlocks:false,
        reliableMarginRight:true,
        boxSizingReliable:true,
        pixelPosition:false
    };

    // Make sure checked status is properly cloned
    // 检测单选框选中状态能否正确克隆
    // 在IE6~9中会返回false,无法正确克隆
    // (1) 设置checkbox的checked为true
    input.checked = true;
    // (2) cloneNode克隆（复制）一份checkbox，获取他的checked值
    support.noCloneChecked = input.cloneNode(true).checked;

    // Make sure that the options inside disabled selects aren't marked as disabled
    // (WebKit marks them as disabled)
    // 检测select元素设置为disabled后，其所有option子元素是否也会被设置为disabled
    // (1)禁用下拉列表
    select.disabled = true;
    // (2)获取下拉列表子元素的disabled是否为true
    // 测试：IE FF Chrome Safair Opera 的opt.disabled都为false，说明option不会被设置为disabled
    // 其他：部分webkit会被设置为disabled,需要老版本的chrome支持。
    support.optDisabled = !opt.disabled;

    // Support: IE<9
    // 检测是否能删除附加在DOM Element 上的属性或数据
    // 在IE6~7中返回false,若事先声明这个属性，那么在IE8返回true，否者返回false
    try {
        delete div.test;
    } catch (e) {
        support.deleteExpando = false;
    }

    // Check if we can trust getAttribute("value")
    // 检测input元素被设置为radio类型后，是否仍然保持原先的值 保持成功返回true，失败返回false
    // 在IE6~9和opera中返回false，其他返回true
    input = document.createElement("input");
    input.setAttribute("value", "");
    support.input = input.getAttribute("value") === "";

    // Check if an input maintains its value after becoming a radio
    input.value = "t";
    input.setAttribute("type", "radio");
    //IE返回on
    support.radioValue = input.value === "t";

    // #11217 - WebKit loses check when the name is after the checked attribute
    // 先“选中”然后在“名称”,顺序要点，在老版本的chroem16和safair 下有兼容问题
    input.setAttribute("checked", "t");
    input.setAttribute("name", "t");
    // 创建一个文档碎片
    fragment = document.createDocumentFragment();

    // 将input元素插入到碎片中
    fragment.appendChild(input);

    // Check if a disconnected checkbox will retain its checked
    // value of true after appended to the DOM (IE6/7)
    // 检测(使用setAttribute)被添加到DOM中的checkbox是否仍然保留原先的选中状态 成功返回true,失败返回false
    // 在IE6~7中，返回false
    // 其他：（1） safair下 若先未设置"名称"，返回true
    // 其他：（2） safair下 若设置"名称"，则返回false
    support.appendChecked = input.checked;

    // WebKit doesn't clone checked state correctly in fragments
    // 检测fragment中的checkbox的选中状态能否被复制 成功返回true,失败返回false
    // 在IE6~7中 失败返回false
    // 其他：（1） safair下 若先设置"名称"后"选中"返回true
    // 其他：（2） safair下 若先设置"选中"后"名称"返回false
    support.checkClone = fragment.cloneNode(true).cloneNode(true).lastChild.checked;

    // Support: IE<9
    // Opera does not clone events (and typeof div.attachEvent === undefined).
    // IE9-10 clones events bound via attachEvent, but they don't trigger with .click()
    // 检测克隆 DOM Element 是否会连同Element一起克隆(复制),成功返回false，失败返回true
    // IE6~8克隆会复制事件,标准浏览器返回false
    // (1)IE的注册事件
    if (div.attachEvent) {
        div.attachEvent("onclick", function () {
            support.noCloneEvent = false;
        });
        // (2)克隆DOM Element并执行onclick事件
        div.cloneNode(true).click();
    }

    // Support: IE<9 (lack submit/change bubble), Firefox 17+ (lack focusin event)
    // Beware of CSP restrictions (https://developer.mozilla.org/en/Security/CSP), test/csp.php
    // 检测(嗅探)事件是否支持
    // 其他： IE6~7不支持submitBubbles和changeBubbles，支持focusinBubbles. IE8~9均支持
    for (i in { submit:true, change:true, focusin:true }) {
        div.setAttribute(eventName = "on" + i, "t");
        //eventName in window 低版本iE6~7浏览器检测，返回false
        //高版本IE8~9浏览器检测
        support[i + "Bubbles"] = eventName in window || div.attributes[eventName].expando === false;
    }
    //IE9的问题，对于克隆的元素清除掉其background时，其原型的background也会被清除
    div.style.backgroundClip = "content-box";
    div.cloneNode(true).style.backgroundClip = "";
    // 检测原型的background是否被清除
    support.clearCloneStyle = div.style.backgroundClip === "content-box";

    // Run tests that need a body at doc ready
    // 页面加载完成之后开始执行
    jQuery(function () {
        var container, marginDiv, tds,
        // 声明保存一种样式（目的是重置样式）
            divReset = "padding:0;margin:0;border:0;display:block;box-sizing:content-box;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;",
        // 获取body元素
            body = document.getElementsByTagName("body")[0];

        if (!body) {
            // Return for frameset docs that don't have a body
            // 框架的页面没有body元素，返回空值
            return;
        }
        // 创建DOM Element元素(div)
        container = document.createElement("div");
        // 设置 DIV 样式
        container.style.cssText = "border:0;width:0;height:0;position:absolute;top:0;left:-9999px;margin-top:1px";
        // 将DIV插入到body第一行
        body.appendChild(container).appendChild(div);

        // Support: IE8
        // Check if table cells still have offsetWidth/Height when they are set
        // to display:none and there are still other visible table cells in a
        // table row; if so, offsetWidth/Height are not reliable for use when
        // determining if an element has been hidden directly using
        // display:none (it is still safe to use offsets if a parent element is
        // hidden; don safety goggles and see bug #4512 for more information).
        // 插入table表格
        div.innerHTML = "<table><tr><td></td><td>t</td></tr></table>";
        // 获取TD
        tds = div.getElementsByTagName("td");
        // 检测none状态下，offsetHeight值是否正确,正确返回true，失败返回false
        // 在IE6~8下返回false
        // (1)设置TD[0]样式
        tds[0].style.cssText = "padding:0;margin:0;border:0;display:none";
        // (2)检测TD[0]的内容高度是否为0
        isSupported = (tds[0].offsetHeight === 0);
        // 检测TD初始化，相邻的td的隐藏，offsetHeight值是否正确,正确返回true，失败返回false
        // 在IE6~8返回false
        // 设置TD[0]display(显示)初始化,相邻的td隐藏
        tds[0].style.display = "";
        tds[1].style.display = "none";

        // Support: IE8
        // Check if empty table cells still have offsetWidth/Height
        support.reliableHiddenOffsets = isSupported && (tds[0].offsetHeight === 0);

        // Check box-sizing and margin behavior
        // 清理div子元素
        div.innerHTML = "";
        // 设置盒模型以及margin等行为
        div.style.cssText = "box-sizing:border-box;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;padding:1px;border:1px;display:block;width:4px;margin-top:1%;position:absolute;top:1%;";
        // 检测是否符盒模型(通过offsetWidth来判断)
        // 在IE6~7中返回false 返回值为6
        support.boxSizing = (div.offsetWidth === 4);

        // 字面翻译：body偏移不是因为margin影响 (未验证)
        support.doesNotIncludeMarginInBodyOffset = (body.offsetTop !== 1);

        // Use window.getComputedStyle because jsdom on node.js will break without it.
        // 未来判断(向上检测)
        // 判断是否支持getComputedStyle方法
        // getComputedStyle:获取当前元素所有最终使用的CSS属性值,返回的是一个CSS样式声明对象
        if (window.getComputedStyle) {
            // 检测图层定位（像素位置）是否有误,正确返回false 错误返回true
            support.pixelPosition = (window.getComputedStyle(div, null) || {}).top !== "1%";
            // 检测盒模型是否可靠
            support.boxSizingReliable = (window.getComputedStyle(div, null) || { width:"4px" }).width === "4px";

            // Check if div with explicit width and no margin-right incorrectly
            // gets computed margin-right based on width of container. (#3333)
            // Fails in WebKit before Feb 2011 nightlies
            // WebKit Bug 13343 - getComputedStyle returns wrong value for margin-right
            // 为处理某个BUG存在,块级元素margin right兼容问题
            // webkit 返回错误的值
            // 创建一个div元素
            marginDiv = div.appendChild(document.createElement("div"));
            // 样式声明或（重置)
            marginDiv.style.cssText = div.style.cssText = divReset;
            marginDiv.style.marginRight = marginDiv.style.width = "0";
            div.style.width = "1px";

            support.reliableMarginRight =
                !parseFloat((window.getComputedStyle(marginDiv, null) || {}).marginRight);
        }
        // FF不支持zoom 检测IE6~7 版本
        if (typeof div.style.zoom !== core_strundefined) {
            // Support: IE<8
            // Check if natively block-level elements act like inline-block
            // elements when setting their display to 'inline' and giving
            // them layout
            div.innerHTML = "";
            div.style.cssText = divReset + "width:1px;padding:1px;display:inline;zoom:1";
            // 检测IE6~7下，块元素在display:inline并拥有layout属性，是否会按inline-block显示
            support.inlineBlockNeedsLayout = (div.offsetWidth === 3);

            // Support: IE6
            // Check if elements with layout shrink-wrap their children
            // 检测父元素拥有layout属性和固定的width/height，是否会被子元素撑大。成功返回true失败,返回false
            // 在IE6中返回true，(值是7)
            div.style.display = "block";
            div.innerHTML = "<div></div>";
            div.firstChild.style.width = "5px";
            support.shrinkWrapBlocks = (div.offsetWidth !== 3);

            if (support.inlineBlockNeedsLayout) {
                // Prevent IE 6 from affecting layout for positioned elements #11048
                // Prevent IE from shrinking the body in IE 7 mode #12869
                // Support: IE<8
                body.style.zoom = 1;
            }
        }
        // 移除container元素 垃圾回收,避免内存泄露
        body.removeChild(container);

        // Null elements to avoid leaks in IE
        container = div = tds = marginDiv = null;
    });
    // IE下，创建DOM Element对象，如果没有append到页面中，刷新页面，这部分内存是不会回收的
    // 不需要的DOM Element，需要做结束清理
    // 释放dom元素占用的内存
    // 释放DOM Element对象,垃圾清理，内存回收
    // Null elements to avoid leaks in IE
    all = select = fragment = opt = a = input = null;
    // 返回结果
    return support;
})();