JQuery语法提示配置文件(含中文解释)

/* * This file has been commented to support Visual Studio Intellisense. * You should not use this file at runtime inside the browser--it is only * intended to be used only for design-time IntelliSense. Please use the * standard jQuery library for all production use. * * Comment version: 1.3.2b */ /* 1.3.2 汉化说明 本汉化文件部分翻译取自 1.2.6-vsdoc-cn 文件。 经本人整合、校对与增加新版帮助文档，供免费学习与个人使用，若有商业需求请联系作者。 更深的蓝， QQ621394 E-mail:topskill@gmail.com 2009-12-21: 增加：insertAfter,insertBefore,prependTo,live,die 的翻译。 增加：innerHeight, innerWidth, outerHeight and outerWidth 的翻译。 增加：offset 的翻译。 增加：scrollLeft and scrollTop 增加：attr的详细描述。 2009-12-20: 修正：检查所有注释的param节，使其与函数声明一致。 修正：clone 的文档错误（源文档有错误）。 修正：noConflict 文档补充。 修正：toggle 的翻译。 修正：完善fadeTo的翻译。 2009-12-18: 修正：window.JQuery 文档错误。 修正：noConflict 翻译错误。 修正：$.grep 文档去除了 lambda 格式的说明(当前版本已不支持) 修正：$.map 文档去除了 lambda 格式的说明(当前版本已不支持) 修正：appendTo,prependTo,insertBefore,insertAfter 和 replaceAll 增加了对 1.3.2 的特别说明 修正：ready 函数增加了特别说明。 增加：closest 选择器的翻译。 增加：isArray 翻译。 增加：mouseenter,mouseleave 的翻译。 增加：slideDown,slideUp,slideToggle 的翻译。 增加：fadeIn,fadeOut 的翻译。 TODO：setArray TODO：queue,dqueue */ /* 原 1.2.6 汉化说明 *billsquall汉化 *感谢之前为API1.1 1.2汉化的各位高手，参考了不少^^ *感谢shawphy，鼓励我的好人！ *不知道有没有侵权的说法，反正这汉化仅供大家参考，版权方面不负任何责任。 *估计不会有人拿去做什么吧？不要用做商业用途，否则后果自负。 */ /* jsDoc By Arliang http://hi.baidu.com/XoB_ArL * 声明上面都有了，我就不重复了。感谢上面的各位兄弟。 * 本jsDoc版是从jquery-1.3.2.min-vsdoc.js中替换得来的（不知道为什么有min，写错了？） * * 本Profile适用于Spket IDE，jQuery-1.3.2语法智能感知配置文件。 * * 2010-1-10 jsDoc Version 1.0.1 * 一开始直接把vsdoc版的放到Profile里面，结果连自动完成都没了， * 最后发现是文件编码的问题，把文件转换成UTF-8（带BOM，否则会是乱码），就可以了。 * 顺便提一下Spket IDE自动完成的问题 * 如果自动提示没有出来，先检查文件的编码，是UTF-8（带BOM）， * 如果还不行就试一下Reload JavaScript Profile，在Spket IDE 1.6.18中，Reload JavaScript Profile * 功能是在Project Explorer项目的右键菜单中的。 * 注意是Project，不是Profile。我给Spket IDE的作者Eric Suen发邮件问了这个问题，他回复了我， * 但我却把Project看成了Profile，结果浪费了不少时间。 * jsDoc跟vsdoc最大的不同是，jsDoc是放在函数的前面，而vsdoc是在函数里面的最前面，这个没想到 * 好法子替换（匹配行的问题，不知怎么不行），只能一个一个地把它拖到前面（还好只是八十几个） * 修正一些错误，比如错别字“清楚 -> 清除” “整形 -> 整型”^_^。 * 把{type}跟param连起来，这样在自动提示的时候才不会把@param跟参数名断开 * 在说明文字里添加了列表标签，这样好看些了。 * 最后，Enjoy Programing。 */ // 附上做替换的宏（EmEditor宏）： // var replaces = [ // //添加结束*/ // '^((\\s*)///\\s<.*>)$\\n(?!\\s*///)', // '\\1\\n\\2 */\\n\\n', // // //删除结束标签 // '\\n\\s*///\\s*</\\w+>', // '', // // //替换开始标签 // '///\\t<summary>', // '/**', // // // /// <param name="selector" type="String">用于匹配的类名</param> // // * @param {String}selector // // * 用于匹配的类名 // //分行 // '^(\\s*)///\\s*<(\\w+)s? name="(\\w+)" [tT]ype="(\\w+)"\\s*>(.+)</\\2s?>', // '\\1 * @\\2 \\{\\4\\} \\3\\n\\1 * \\t\\t\\5', // // '^(\\s*)///\\s*<(\\w+)s? name="(\\w+)" [tT]ype="(\\w+)"\\s*>', // '\\1 * @\\2 \\{\\4\\} \\3', // //<param name="data" optional="true" type="Array">(可选)传递给事件处理函数的附加参数</param> // //可选参数 // '///\\s*<(param) name="(\\w+)" optional="true" [tT]ype="(\\w+)">', // ' * @\\1 \\{\\3\\} \\2', // // '///\\s*<(param) name="(\\w+)" [tT]ype="(\\w+)">', // ' * @\\1 \\{\\3\\} \\2', // // '///\\s*<returns type="(\\w+)".+/>', // ' * @return \\{\\1\\}', // // '^(\\s*)///\\s*<(\\w+)s [tT]ype="(\\w+)"\\s*>(.+)</\\2s>', // '\\1 * @\\2 \\3\\n\\1 * \\t\\t\\4', // // '///\\s*<private />', // ' * @private', // // //把中间的///替换成 .*. // '///(\\s*)', // ' * \\1', // ]; // // for(var i = 0,len = replaces.length; i < len; i += 2){ // document.selection.StartOfDocument(false); // document.selection.Replace(replaces[i],replaces[i+1],eeFindNext | eeFindReplaceEscSeq | eeReplaceAll | eeFindReplaceRegExp); // } // document.selection.StartOfDocument(false); // document.selection.Find("\\*\\s*<",eeFindNext | eeFindReplaceCase | eeFindReplaceEscSeq | eeFindReplaceRegExp); // // //上面的步骤完成后，还有二十一个没有正确替换，自己手动查找"\*\s*<"来替换 /* * jQuery JavaScript Library v1.3.2 * http://jquery.com/ * * Copyright (c) 2009 John Resig * * Permission is hereby granted, free of charge, to any person obtaining * a copy of this software and associated documentation files (the * "Software"), to deal in the Software without restriction, including * without limitation the rights to use, copy, modify, merge, publish, * distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to * the following conditions: * * The above copyright notice and this permission notice shall be * included in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. * * Date: 2009-02-19 17:34:21 -0500 (Thu, 19 Feb 2009) * Revision: 6246 */ (function(){ var // Will speed up references to window, and allows munging its name. window = this, // Will speed up references to undefined, and allows munging its name. undefined, // Map over jQuery in case of overwrite _jQuery = window.jQuery, // Map over the $ in case of overwrite _$ = window.$, /** * <ul><li>1: $(expression, context) - 这个函数接收一个包含 CSS 选择器的字符串，然后用这个字符串去匹配一组元素。</li> * <li>2: $(html) - 根据提供的原始 HTML 标记字符串，动态创建由 jQuery 对象包装的 DOM 元素。</li> * <li>3: $(elements) - 将一个或多个DOM元素转化为jQuery对象。</li> * <li>4: $(callback) - $(document).ready()的简写。</li></ul> * @param {String}selector * <ul><li>1: expression - 用来查找的表达式。</li> * <li>2: html -用于动态创建DOM元素的HTML标记字符串</li> * <li>3: elements - 用于封装成jQuery对象的DOM元素</li> * <li>4: callback - 当DOM加载完成