只为成功找方向,不为失败找借口

每天都不能停止前进的脚步
  博客园  :: 首页  :: 新随笔  :: 联系 :: 订阅 订阅  :: 管理

转载:VS 2008中的jQuery Intellisense

Posted on 2009-03-04 18:32  冰碟  阅读(1396)  评论(1编辑  收藏  举报

转载自:1, http://blog.joycode.com/scottgu/archive/2008/11/22/115357.aspx

     2, http://www.cnblogs.com/wuchang/archive/2008/02/18/1072797.html#1105091

1,

VS 2008中的jQuery Intellisense

在VS 2008中启用jQuery Intellisense的步骤

要在VS中启用jQuery的intellisense完成,你要遵循三个步骤:

第一步: 安装VS 2008 SP1

VS 2008 SP1 在Visual Studio中加了更丰富的JavaScript intellisense支持,对很大部分的JavaScript库加了代码完成支持。

你可以在这里下载VS 2008 SP1 和 Visual Web Developer 2008 Express SP1。

第二步: 安装VS 2008 Patch KB958502以支持"-vsdoc.js"Intellisense文件

2个星期前,我们发布了一个补丁,你可以将其运用到VS 2008 SP1 和 VWD 2008 Express SP1版本上,该补丁会导致Visual Studio在一个JavaScript库被引用时,查找是否存在一个可选的"-vsdoc.js"文件,如果存在的话,就用它来驱动JavaScript intellisense引擎。

这些加了注释的"-vsdoc.js"文件可以包含对JavaScript方法提供了帮助文档的XML注释,以及对无法自动推断出的动态JavaScript签名的另外的代码intellisense提示。你可以在这里了解该补丁的详情。你可以在这里免费下载该补丁。

第三步: 下载jQuery-vsdoc.js文件

我们与jQuery开发团队合作编写了一个jQuery-vsdoc.js文件,该文件对串连的jQuery selector方法的JavaScript intellisense提供了帮助注释和支持。你可以在jQuery.com网站的官方下载网页上下载jQuery和jQuery-vsdoc文件:

把jquery-vsdoc.js保存到你项目中jquery.js文件所在的同一个目录中(同时确认它的命名前缀与jquery文件名匹配):

然后你可以象这样,通过一个html <script/>元素来引用标准的jquery文件:

或者也可以使用<asp:scriptmanager/> 控件来引用它,或者在一个单独的.js文件的顶部加 /// <reference/> 注释来引用它:

在完成之后,VS就会在你引用的脚本文件所在的同一个目录中寻找一个-vsdoc.js文件,如果找到的话,就会用它来做帮助和intellisense。

2,

上周Rich Strahl的POST中提到一个新发布的VS2008 hotfix修复了VS2008对Javascript智能感知的一些BUG,fixed之后可以让VS2008对JQuery提供智能感知,让我等JQuery fans欣喜了一阵子。可仔细一看,还需要另外给JQuery添加上XML comments才行 :(  丧气了...  

一、

刚才看到已经有快手的牛人做完了这项工作,现在可以直接下载(http://data.lancefisher.net/jquery-1.2.3-intellisense.js)回来用了。

这样引用就行了

<script src="jquery-1.2.3-intellisense.js" type="text/javascript"></script>

如果是在独立的.js文件中需要JQuery智能提示,那么在文件开始加上这行

/// <reference path="jquery-1.2.3-intellisense.js" />

就OK了。

但这个JS是未压缩版的jqery1.2.3,加上XML comments,有120K之巨,开发时用就行了,部署的时候可以换个pack版本的。

不过似乎VS2008对JS的智能感知还有点不足的地方,比如js中的重载函数就不能提供很好的提示支持...希望能再有改进

二、

另外,还有个JQuery XML comments的生成器JQuery IntelliSense Header Generator,这个生成器是根据JQuery官方提供的XML DOC来生成JQuery的函数签名和XML comments。注意,这里只生成函数签名,没有具体的实现。如果嫌第一种方法部署麻烦,那么就可以使用这个签名JS了,我们可以把脚本全部放到独立的.js文件中,然后在js中reference 这个假的JQuery,而在.aspx中则引用真正Pack版的jquery。

这个生成器有个BUG,因为jquery xml doc有些函数的说明中有些有回车符,而这个生成器没有做处理,导致生成的签名JS有误。

我修正了这个BUG,需要的同学可以点击这里下载。记住:这个生成器只生成jq函数签名和XML comments;这个生成器是根据JQuery官方的的XML API doc生成的,也就是说如果以后有版的JQuery API doc出来,你只要把它下载回来覆盖掉这个旧的就行了。

这个生成器生成的签名有个比较好的地方,就是它把重载方法的comments都放到一起了,也就是vs2008的智能提示中可以看到几个不同重载的comments.

出处:http://wuchang.cnblogs.com  email: wuchangx # qq.com

下面看下效果图:

image

图1

image

图2

image_thumb_2

图3

 

补充,如果修改脚本文件后,而VS2008的智能提示没有及时更新,那么可以使用快捷键Ctrl+Shift+J来更新一下。

 image