JSDOC 注释格式

Question

I have a property in a polymer class inside static property getter, defined like this, with comment about it above the property.

  /**
  * 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: ''
  },

I am generating documentation for the same using JSDOC, and I am encountering a weird problem, In the generated docs, this is how how comment mentioned over property looks like.

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

Somehow, while generating documentation JSDOC in the not understanding <text> in the comment.

Any insights on this will be helpful, thanks:)

Answer 1

These blocks are treated as markdown, so your <text> is being ignored as unconvertable html.

Escape the tag with backticks `<text>` ) or use \< to escape your "less than" symbol.

eg:

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

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

Answer 2

I managed to solve the problem, As we know that.

• < stands for the [less-than sign][1] ( < ).
• > stands for the [greater-than sign][2] ( > ).

Replace < with < and > with > in the comment will solve the problem.