描述:描述一个相关属性的集合。
@enum [<type>]
@enum标签描述一个静态属性值的全部相同的集合。枚举类似一个属性的集合,除了枚举自己的描述注释之外,属性都记录在容器内部的注释中。通常这种标签是与@ReadOnly
结合使用,作为一个枚举通常表示常量的集合。
这个例子表明如何记录一个对象,这个对象有三个可能的状态的值。请注意,枚举成员可以添加一个可选的描述,如果你的希望的话。你也可以覆盖类型,如下所示的"MAYBE" -- 默认情况下,枚举成员将被记录为与枚举本身相同的类型。
例如,一个数字枚举,表示的3种状态:
- /**
- * Enum for tri-state values.
- * @readonly
- * @enum {number}
- */
- var triState = {
- /** The true value */
- TRUE: 1,
- FALSE: -1,
- /** @type {boolean} */
- MAYBE: true
- };