javascript - @scope 在 sproutcore 中的含义

Question

我正在使用 sproutcore，我使用 sc-gen 生成这样的 Controller (这是来自 sproutcore Todos 教程):

sc-gen controller Todos.tasksController SC.ArrayController

在生成的 javascript 文件中，我找到了这个 javascript 注释行:

/** @scope Todos.tasksController.prototype */

我想知道这个@scope 做了什么。这是必要的吗？什么工具正在解析这个@scope 关键字？这是 sproutcore 特有的东西还是一般在 javascript 中使用？

Answer 1

SproutCore 支持生成文档的 JSDoc 标准。

@scope 语法是其中的一部分。这里有更深入的解释:

http://code.google.com/p/jsdoc-toolkit/wiki/DocExamples#Changing_Scope

如果您不打算使用 JSDoc，则您自己的代码没有必要。但如果您这样做，或者您使用的是支持 JSDoc 的编辑器/IDE(例如 JetBrains WebStorm)，那么最好将其保留在其中。

在构建您的 SC 应用程序时，所有评论都会被删除(缩小)，因此不会影响您的应用程序的大小。