【问题标题】:JSDOC Comment formatJSDOC 注释格式
【发布时间】:2019-10-16 11:01:47
【问题描述】:

我在静态属性 getter 内的聚合物类中有一个属性,定义如下,在属性上方有关于它的注释。

  /**
  * when textElement is empty, textElement (<text> tag) is used for limited text instead of advanced text features.
  * @name textElement
  * @alias textElement
  * @memberof ABC
  * @type {Boolean}
  */
  textElement: {
    type: String,
    value: ''
  },

我正在使用 JSDOC 生成相同的文档,我遇到了一个奇怪的问题,在生成的文档中,这就是属性上提到的注释的样子。

when textElement is empty, textElement ( tag) is used for limited text instead of advanced text features.

不知何故,在生成文档 JSDOC 的时候不理解 &lt;text&gt; 的评论。

对此的任何见解都会有所帮助,谢谢:)

【问题讨论】:

    标签: javascript polymer documentation jsdoc


    【解决方案1】:

    据我们所知,我设法解决了这个问题。

    • &amp;lt; 代表 [小于号][1] (
    • &amp;gt; 代表 [大于号][2] ( > )。

    将评论中的&amp;lt; 替换为&amp;lt; 和> 替换为&amp;gt; 将解决问题。

    【讨论】:

      猜你喜欢
      • 2015-06-02
      • 1970-01-01
      • 2012-02-03
      • 2011-09-20
      • 2018-12-27
      • 2015-04-09
      • 1970-01-01
      • 2020-12-30
      • 1970-01-01
      相关资源
      最近更新 更多