Question

如何使用ngDoc记录常量？我没有看到用于记录.constant注册的值的任何角度特定文档，并且常量的jsDoc语法似乎在通过ngDoc运行时生成任何实际文档。 / p>

例如：

/** * @constant * @name WHITE * * @description * The color white! **/ module.constant( 'WHITE', '#fff' );

Answer 1

ngDocs目前还没有提供记录常量的方法。正如您在templating source code中看到的那样。没有相关的html_usage_*方法。

我记录这样的常量，然后将APP_CONFIG显示为模块。

/**
 * @ngdoc object
 * @name APP_CONFIG
 * @description
 *   constant...
 * @example
 * APP_CONFIG is injectable as constant (as a service even to .config())
 * <pre>
 * (...)    .config(function ($APP_CONFIG) {
 * </pre>
 */

Answer 2

应该是@const

/** @const */ var MY_BEER = 'stout';

/**
 * My namespace's favorite kind of beer.
 * @const {string}
 */
mynamespace.MY_BEER = 'stout';

/** @const */ MyClass.MY_BEER = 'stout';

/**
 * Initializes the request.
 * @const
 */
mynamespace.Request.prototype.initialize = function() {
  // This method cannot be overridden in a subclass.
};

有关更多信息，请参阅常量部分http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml#Constants和注释部分http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml?showone=Comments#Comments

使用ngDoc记录常量

2 个答案: