@public
描述: 标记为公开的。
概述
@public
标签标记标识符为公开的。
默认情况下,JSDoc把所有标识符当做公开的,因此使用这个标记一般不会影响生成的文档。 然而,你可能更愿意明确地使用 @public
标签,这样可以更加清晰的标明你要公开的标识符。
在JSDoc 3中,@public
标签不影响标识符的作用域。使用@instance
, @static
, 和 @global
标签会改变标识符的作用域。
例子
使用 @public 标签:
/** * The Thingy class is available to all. * @public * @class */ function Thingy() { /** * The Thingy~foo member. Note that 'foo' is still an inner member * of 'Thingy', in spite of the @public tag. * @public */ var foo = 0; }