美文网首页
js命名规范

js命名规范

作者: 小母鸡叽叽叽 | 来源:发表于2018-05-04 14:12 被阅读1057次

js命名应遵循 简洁、语义化 的原则

一、变量

命名方法: 小驼峰式命名法
命名规范:前缀为形容词 (函数前缀为动词, 以此来区分函数和变量)

# 好的命名方式
let maxCount = 10;
let tableTitle = '啦啦啦';
# 不好的命名方式
let setConut = 10;
let getTitle = '啦啦啦';

二、常量

命名方法:名词全部大写
命名规范:使用大写字母和下划线来组合命名,下划线用来分割单词。

const MAX_COUNT = 10;
const URL = '//www.huifenqi.com';

三、函数 & 方法

命名方法: 小驼峰式命名法
命名规范: 前缀应该为动词
命名建议:常用动词约定

动词 含义
can 判断是否可执行某个动作
has 判断是否含义某个值
is 判断是否为某个值
get 获取某个值
set 设置某个值
load 加载某些数据
// 是否可阅读
function canRead() {}
// 获取名称
function getName() {}

四、类 & 构造函数

命名方法:大写驼峰式命名法,首字母大写。
命名规范:前缀为名称。

class Persion {
  constructor(name) {
   ...
  }
}

let person = new Person('啦啦啦');

五、类的成员

类的成员包括:

  1. 公共属性和方法: 跟变量和函数命名一样。
  2. 私有属性和方法:前缀为下划线_, 后面跟公共属性和方法一样的命名方式。
class Person {
  // 私有属性 
  _name: string;
  constructor() { }

  // 公共方法
  getName() {
    return this._name;
  }
  // 公共方法
  setName(name) {
    this._name = name;
  }
}

六、注释规范

格式化插件推荐prettier
6.1 单行注释

// 设置标题
setTitle()

6.2 多行注释

/*
 * 代码执行到这里后会调用setTitle()函数
 * setTitle():设置title的值
 */
setTitle();

6.3 函数 & 方法注释

/**
 * 函数说明
 * @关键字
 **/

常用关键字注释

注释名 语法 含义 示例
@param @param {参数类型} 描述信息 描述参数 @param {String} name 传入名称
@return @return {参数类型} 描述信息 描述返回值 @retun {Boolean} true: 可执行; false: 不可执行
@author @author 描述信息 描述作者 @author 某某某 2018/04/24
@example @example 示例代码 演示函数的使用 @example setTitle('啦啦啦');

七、vue常用开发规范

7.1 import

import 应置于顶层, 引入组件名遵循大写驼峰式命名法。

import ElInput form '***'
import Emitter from '***'

7.2 methods

命名方法:同函数命名法
命名建议:事件处理应以handle开头,如handleBlur
其他建议:使用promiseasync/await处理异步逻辑,避免使用回调函数。

7.3 少使用watch, 直接监听事件。

7.4 合理利用style的scope属性,隔离页面样式。通用组件应避免使用scope.

相关文章

  • jquery$符号

    js命名规范允许的字符有:数字、字母、下划线、$。js命名规范允许为变量命名开头的字符有:字母、下划线、$;但是不...

  • 项目开发规范参考

    现有项目的开发规范文档 目录 命名规则文件命名 HTML规范 CSS规范 JS规范变量申明简写代码性能优化注释规范...

  • 《javascript基础补充--开发规范》

    JavaScript 开发规范 本篇文章主要介绍了JS的命名规范、注释规范以及开发的一些问题 目录 命名规范:介绍...

  • js命名规范

    js命名应遵循 简洁、语义化 的原则 一、变量 命名方法: 小驼峰式命名法命名规范:前缀为形容词 (函数前缀为动词...

  • JS命名规范

    js:驼峰 firstNamecss:中划线 first-nameclass : FirstNamehtml : ...

  • 【JS】命名规范

    class/id 横线 常量全大写 变量下划线 临时变量下划线开头 函数 驼峰 类 大驼峰(帕斯卡) 文件 下划线...

  • Web前端编码及注释规范

    一、命名规范 Web前端开发中的命名包括,项目命名、目录命名、JS文件命名、CSS文件命名、HTML文件命名等,详...

  • [转] js开发规范

    本篇主要介绍JS的命名规范、注释规范以及框架开发的一些问题。 目录 [命名规范]:介绍变量、函数、常量、构造函数、...

  • 前端基本开发规范

    一般规范 HTML书写规范 CSS书写规范 JavaScript书写规范 一般规范 文件资源命名 资源(图片、js...

  • 前端css命名规范

    1,10 命名规范 如何命名 • css最好用class来命名,js用id来命名,已做区分 • id和class的...

网友评论

      本文标题:js命名规范

      本文链接:https://www.haomeiwen.com/subject/qvldrftx.html