@code 在 Google 闭包中是什么意思?
What does @code mean in Google Closure?
这里有一个例子:
* An implementation of {@code goog.events.Listenable} with full W3C
* EventTarget-like support (capture/bubble mechanism,
https://developer.pubref.org/static/apidoc/global/closure/goog/events/EventTarget.html
我能猜到它的意思,但我在哪里可以找到它的确切定义?我检查了所有 Google Closure Annotation 文档,但找不到。谢谢:)
已更新
根据我的新理解;由于 JSDocs 支持降价。 {@code FooBar} 因此被弃用,取而代之的是反引号 `FooBar`
.
旧
您可以在 Closure API's documentation page for goog.events.EventTarget.
上看到您所询问的文档的输出
当呈现 JSDocs 时,@code 标记将导致括号中的代码作为 <code></code>
元素呈现。
来源:js-dossier
JavaDocs 中还有更好的文档...文档:
{@code text}
相当于{@literal}
.
以代码字体显示文本,而不将文本解释为 HTML 标记或嵌套的 javadoc 标记。这使您能够在文档注释中使用常规尖括号(< 和 >)而不是 HTML 实体(< 和 >),例如在参数类型 ()、不等式 (3 < 4) 或箭头 (< -).例如文档注释文本:
{@code A<B>C}
在生成的HTML页面中显示不变,如:
A<B>C
值得注意的一点是,不被解释为粗体,而是代码字体。
如果您想在没有代码字体的情况下使用相同的功能,请使用 {@literal}。
这里有一个例子:
* An implementation of {@code goog.events.Listenable} with full W3C
* EventTarget-like support (capture/bubble mechanism,
https://developer.pubref.org/static/apidoc/global/closure/goog/events/EventTarget.html
我能猜到它的意思,但我在哪里可以找到它的确切定义?我检查了所有 Google Closure Annotation 文档,但找不到。谢谢:)
已更新
根据我的新理解;由于 JSDocs 支持降价。 {@code FooBar} 因此被弃用,取而代之的是反引号 `FooBar`
.
旧
您可以在 Closure API's documentation page for goog.events.EventTarget.
上看到您所询问的文档的输出当呈现 JSDocs 时,@code 标记将导致括号中的代码作为 <code></code>
元素呈现。
来源:js-dossier
JavaDocs 中还有更好的文档...文档:
{@code text}
相当于
{@literal}
.以代码字体显示文本,而不将文本解释为 HTML 标记或嵌套的 javadoc 标记。这使您能够在文档注释中使用常规尖括号(< 和 >)而不是 HTML 实体(< 和 >),例如在参数类型 ()、不等式 (3 < 4) 或箭头 (< -).例如文档注释文本:
{@code A<B>C}
在生成的HTML页面中显示不变,如:
A<B>C
值得注意的一点是,不被解释为粗体,而是代码字体。 如果您想在没有代码字体的情况下使用相同的功能,请使用 {@literal}。