文档注释

Posted 会飞的小白

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了文档注释相关的知识,希望对你有一定的参考价值。

基础注释
@param number [duration] \'[]\' 表示可选

/**
 * 函数防抖
 * @listens 
 * @param function func 目标函数
 * @param number [duration] 延迟执行的时间 【[] 表示可选】
 * @return function 防抖的函数
 */
function dobounce(func, duration = 100) 

dobounce()

示例注释
@exports getRandom (1, 10) // 获取[1,10] 之间的随机数

/**
 * 获取指范围内的随机整数
 * @author 刘远翔 <123@qq.com> 作者 邮箱
 * @param number min 随机数的最小值
 * @param number max 随机数的最大值
 * @return number 随机数 【返回值】
 * @exports 
 * getRandom(1, 10) // 获取[1,10] 之间的随机数  【示例代码】
 */
function getRandom(min,max) 
  

对象注释

/**
 * 网络请求
 * @param object options 配置对象
 * @param object options.url 请求地址
 * @param \'GET\'|\'POST\' options.method 请求类型
 * @param object options.body
 * @param object options.headers
 */
async function require(options) 



require(
  method: \'GET\'
)

eclipse中单行注释,多行注释,文档注释

一、单行注释(也可以多行注释)

1、样式://我是被注释的内容

2、快捷键:ctrl+/   或   ctrl+shift+C

二、多行注释(也可以单行注释)

1、样式:/*我是被注释的内容*/

2、快捷键:ctrl+shift+/

三、文档注释

1、样式:/**我是被注释的文档*/

2、快捷键:Alt+shift+J

3、修改文档注释的文档内容:      

 

以上是关于文档注释的主要内容,如果未能解决你的问题,请参考以下文章

eclipse中单行注释,多行注释,文档注释

编程中的注释分为三类 单行注释,多行注释,文档注释;

IDEA快速文档显示方法注释问题?

eclipse中java的单行注释多行注释文档注释的快捷键

Java基础入门 - 三种注释及文档注释详解

文档注释