P10-基础-注释.js

/*P10-注释
//注释，3种方式：
//1.单行，使用//开头
//2.多行用/*开头，和* /结尾。
//3.文档注释，api文档，使用专门工具生成api文档,

// 1.单行
// 姓名
var myName ='张恒';

// 2.多行
//VH：注意/** /会破坏{}的组合，/*{* /}的意思是/*{* /。注意，本行内* /表示是多行注释的关闭符号*和/，这里加空格阻止生效。
/*
下方的代码是为了完成以下操作：
1.获取表单的值
2.提交表单
*/

//VH：前面可以有多个/*abc/*abc* /一个*和/的组合就可以关闭上面这么多的/和*；
//【这是后面章节学习的时候，为了注释学过的节发现的，大概是函数部分。】

/*123123123
/*123123123
*/

// 3.api文档，在函数上面一行，输入/**回车自动添加api注释，然后可以进行编辑完善

/**
 * 对两个操作数进行加法运算
 * @param {Object} a 第一个操作数
 * @param {Object} b 第二个操作数
 * @returns 返回两个操作数的和
 */
function add(a,b){
 return a+b;    
}
add(1,2)//鼠标放在函数上，参数上，会显示对应的文档注释,vscode可以，但是hbuilder不行

//这里添加P114-模块化的一个例子

/**
 * 
 * @param {Date} date //{}内的内容，修改成Date
 * @returns 
 */
export function formatDate(date){
    return `${date.getFullYear()}-${date.getMonth()}-${date.getDate()}`
}
//* @param {Date} date //{}内的内容，修改成Date
//没使用注释掉时候，date.输入到这有提示date和formateDate
//使用了这个注释，date.输入到这会有很多Date对象的方法就出来了。

/** */

---