问题标签 [vsdoc]

When I'm using the Google CDN to acquire the jQuery library, how do I then reference the companion Microsoft CDN VSDOC file to get IntelliSense support in VS 2010?

So far in documentation I've run across instructions to put the VSDOC file alongside the script file in the same folder (in the website) and abide by the naming convention.
e.g.

However my files aren't on disk. Can I gain IntelliSense over the network without downloading these files?

jQuery VS Doc location at Microsoft CDN:
http://ajax.aspnetcdn.com/ajax/jQuery/jquery-1.6.2-vsdoc.js

JQuery from Google CDN (with Google API key not shown):

是否有 JavaScript 的注释文档格式和生成 HTML 文档的这种格式的处理器？

目前，我正在使用 VSDoc xml 注释在开发时提供 IntelliSense 帮助，但据我所知，没有此类注释的文档生成器。因此，或者我的问题可能听起来像：是否有任何实用程序可以将 VSDoc 注释从 JavaScript 文件转换为 HTML？

昨天我将项目中的 jQuery 移到了 Microsoft 的 CDN，所以终于让 jQuery intellisense 回来了。耶！但是，我显然需要在我的所有 .js 文件中包含以下内容：

我希望有一个包含上述引用的单个 js 文件，这样我在所有 js 文件中都有一个单一的、不变的引用，如下所示：

这个想法是 stdafx.js 将是包含 jQuery 引用的文件。然后我只有一个地方可以更新版本或添加其他参考。我试了一下，但似乎没有用。任何人都可以想出一种方法来实现这一点吗？

有没有人可以下载 jQuery 1.7.1 VSDoc？

还有怎么做才能让它发挥作用？我目前有以下内容，并且在Ctr-Shift-J更新 Intellisense 时，VSDoc 中出现了巨大错误：

我同时拥有 Service Pack 1 和补丁更新以使 VSDoc 在 VS 2008 中工作。

据我了解，您应该能够（安装了KB958502）通过引用脚本（只要旁边有 -vsdoc 版本）来获得 Intellisense for jQuery。

我们很想使用 CDN 来分发它，但只需添加：

给出一个模糊的警告

警告 1 更新 JScript IntelliSense 时出错：C:...\Temporary Internet Files\Content.IE5\4U5FWPZF\jquery-1.7.1-fds90 1 ..js：对象不支持此属性或方法 @ 1352:1 c: \项目...\MyFile.aspx

猜测一下，我会假设它“生闷气”，因为缓存中的文件名不是 jquery-1.7.1-vsdoc.js 的形式，尤其是错误保持不变，即使我去全程：

这仍然行不通。

仅仅是 vsdoc Intellisense 不适用于远程托管文件的情况吗？

我正在重构我的 JavaScript 库以利用单个命名空间。我们有大约 200 个模块，它们以前将自己注册为 jQuery 插件或全局对象（不好）。在过去的分配中，为了让 Intellisense 工作，我为每个模块（我想要 Intellisense）添加了模块引用作为

到每个模块文件的顶部。

前一个时代的一切都是有缺陷的、脆弱的和不优雅的。

我希望在新的分配中解决这个问题。这次重构的主要目标之一是让新开发人员可以轻松地开始在库中工作，而 Intellisense 有很大的好处。

目前，我将所有 *.js 文件连接到一个 nameSpace-vsdoc.js 文件中。每个类的每个方法都使用 vsdoc 语法记录。每个模块都使用它，单个 vsdoc 参考。这工作正常，但它很笨拙。Intellisense 比以前好 300%，但仍然不够准确。它错过了很多我的 xml 文档，并且它不能很好地递归到返回稍微复杂的对象的方法/类中。

YUI Doc 提供了一种从 JsDoc 语法构建文档的方法，但这对 Intellisense 没有帮助。深入的灵魂谷歌搜索未能揭示任何第 3 方解决方案。

是否有任何工具可以以更智能的方式生成 VsDocs？

更新：

经过一些广泛的思考、测试和增量重构，我有了一个看起来像这个 jsFiddle的基本命名空间。

这使我能够在自执行函数中编写松散耦合的模块，这些模块在命名空间上注册所需的方法。所有模块都以：

我使用一个简单的 Perl 脚本生成了这个 vsdoc，该脚本已附加到 VS 2010 构建事件中：

_first-vsdoc.js 和 _last-vsdoc.js 文件将整个内容包装在一个自执行函数中。然后，我根据需要/适当将生成的 vsdoc 传递给 Closure Compiler、YUI Compressor 和 Uglify。

这个过程比以前工作得更好，但它仍然不是没有缺陷。

从头开始，在引用 NameSpace-vsdoc.js 的 NewModule.js 中，我得到了正确的 Intellisense：

但是，当我将 NewModule.js 定义为（并编译）时：

我没有得到适当的智能感知：

这令人困惑，因为它在子命名空间上运行良好。我被迫这样做：

编译，突然（显然）智能感知按预期工作。

Intellisense 使用 jQuery 的 vsdoc（我在构建这个过程时仔细研究过）与链式方法一起工作，并且 jQuery 不会使用y.x = y.x || new x()诡计来实现它。

所以这里是修改后的问题：从结构的角度来看，我能感觉到 jQuery 的 vsdoc 和我自己的唯一可辨别的区别是 jQuery 将整个命名空间组装在同一个闭包内。我的命名空间和我的每个模块都包装在单独的闭包中。相比之下，我的 vsdoc 看起来像是一长串自执行函数。

放弃闭包/模块模式的风险太大了；并且很难孤立地检验假设。Intellisense 在库较小且因此无法生成数千个“Javascript Intellisense Message: C:\\js\NameSpace-vsdoc.js(40:16) : Object required”错误时运行良好。

想法？

在 Visual Studio 中使用包控制台，我们使用安装 jQuery

安装包 jquery

是否也有为相应的 jQuery 文件安装 VS doc 文件的命令？

有-intellisense.js或-vsdoc.js文件用于向 Visual Studio 添加完整的 jQuery 和 jQuery Validation intellisense - 即命名空间、函数、参数、返回值、备注等。

• Underscore有这样的东西吗？您可以通过将库添加到_references.js文件中来获得基本的智能感知，但是上面详述的其余部分呢？

• 是否有一个包含所有当前可用智能感知文件的列表？例如，将这些用于：淘汰赛、Google API（如地图和地理定位）、RequireJS、Bootstrap 等会很棒。

我想在 Visual Studio 中为我在方法调用中使用的选项对象获得 Intellisense 支持。

在 Javascript 中使用包罗万象的选项对象来配置对函数的调用是很常见的——例如 jquery 的 Ajax 调用使用：

其中 settings 只是一个对象，例如：

尽管它是一个隐式对象，但属性遵循特定的类。通常，当您有类似这样的东西对 Intellisense/描述代码很重要但对代码工作不重要时，您可以将它放在 -vsdoc.js 文件中。但是我如何让 Intellisense 为这个对象提供信息呢？

我以jquery-vsdoc.js为例，因为它是由 Microsoft 提供的，但无济于事。在一种情况下，他们只是将其键入为“对象”，而在另一种情况下，他们根本不记录它。

例如，我已经尝试过 - 在 fillTable.js 中：

在 fillTable-vsdoc.js 中：

但是对于 Intellisense，我得到的只是类型是 FillTableOptions - 当我创建对象时，我在选择属性时没有得到 Intellisense 帮助。

那么，如何获得对此类对象属性的 Intellisense 支持？

我有一个脚本 retry.js，其中包含：

显然它有一个主体，但这没关系，因为无论我是否在脚本中有主体，都会出现这个问题。

为了记录这个函数返回的对象，我还有一个辅助的 -vsdoc.js 文件，retry-vsdoc.js：

奇怪的是，如果我删除 -vsdoc.js 文件，Visual Studio 2012 中的 Intellisense 对 retry.js 工作正常（当然，我对它返回的内容没有真正的帮助）。如果我将 -vsdoc.js 保留在原位，则 Intellisense 不再可以使用 retryAjax 函数 - 它不会在键入参数时自动完成或显示 Intellisense 信息。然而，RetryAjaxDeferred 函数在 Intellisense 中确实变得活跃。

显然，-vsdoc.js 文件中的某些内容以某种方式破坏了 retry.js 的 Intellisense，而没有破坏到足以防止其自身内容消失的程度。我究竟做错了什么？