前端代码注释规范

技术前端代码注释规范 前端代码注释规范前端代码注释规范
目的和原则
提高可读性和可维护性
如无必要,勿增注释;如有必要,尽量详尽
语法和快捷键
单行注释:// 快捷键: ctrl+/
多行注释:/**/

前端代码注释规范

前端代码注释规范

目的和原则

提高可读性和可维护性。

如无必要,不要添加评论;必要时尽可能详细。

语法和快捷键

单行注释://快捷键:ctrl/

多行注释:/* */快捷键:ctrl shift/

规范

1.在注释器和注释内容之间添加一个空格。

2.在注释行和上面的代码之间添加一个空行。

HTML

顶部文档注释

/**

* @description:中文描述

* @author:名称

* @update:名称(xxxx-xx-xx)

*/

CSS

/*内容*/

内容

/*结束内容*/

JS

函数

/**

* @func

* @todo此函数需要优化。

* @desc是一个带参数的函数

* @ param { string } a-参数a

* @ param { number } b=1-参数b的默认值为1。

* @ param { string } c=1-参数c有两个受支持的值/br1-用于x/br2-用于xx。

* @ param { object } d-参数d是一个对象。

* @param {string}参数d的d.e-e属性

* @ param { string } d . f-参数d的f属性。

* @ param { object[]} g-参数g是一个对象数组。

* @ param { string } g . h-参数g数组中某项的h属性

* @ param { string } g . I-参数g数组中某项的I属性

* @ param { string }[j]-参数j是可选参数。

* @返回{布尔值}返回值为真。

*/

内容来源网络,如有侵权,联系删除,本文地址:https://www.230890.com/zhan/116869.html

(0)

相关推荐

  • Spring事务知识点(总结)

    技术Spring事务知识点(总结) Spring事务知识点(总结)什么是事务
    答:既是把操作一次数据库的这个操作当成是一个事务,把这个行为抽象了。
    例如:查询一次user表的所有内容叫一次事务。事务的4

    礼包 2021年10月28日
  • Bezier Game有什么优点

    技术Bezier Game有什么优点本篇内容主要讲解“Bezier Game有什么优点”,感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷,实用性强。下面就让小编来带大家学习“Bezier Game有什么优点”吧!  

    攻略 2021年11月12日
  • 排山倒海的倒的意思,排山倒海形常用来形容什么

    技术排山倒海的倒的意思,排山倒海形常用来形容什么排山倒海这个词语常用来形容力量强盛,声势浩大排山倒海的倒的意思。【出自】:宋·杨万里《六月二十四日病起喜雨》:“病势初来敌颇强,排山倒海也难当。”
    【解释】:初来对抗很强势

    生活 2021年10月27日
  • 何为限流

    技术何为限流本篇内容介绍了“何为限流”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!限流算法做限流的时候我们有一些常用的限

    攻略 2021年10月22日
  • 4行4字的古诗,我要60首4行5字的古诗

    技术4行4字的古诗,我要60首4行5字的古诗1,静夜思4行4字的古诗。2,咏鹅。3,终南望余雪。4,登鹳雀楼。5,江雪。6,寻隐者不遇。7,江上渔者。8,夏日绝句。9,所见。10,春夜喜雨。11,八阵图。12,绝句。13

    生活 2021年10月23日
  • Synchronized升级过程是怎样的

    技术Synchronized升级过程是怎样的Synchronized升级过程是怎样的,针对这个问题,这篇文章详细介绍了相对应的分析和解答,希望可以帮助更多想解决这个问题的小伙伴找到更简单易行的方法。要理解Synchron

    攻略 2021年10月20日