代码规范(RL-TOC)用更合理的方式写 JavaScript


  • 代码能够改变世界
  • 不规范代码能够毁掉世界
  • 只有先学会写规范的代码,才能够走的更远

编程语言之间有不少编程规范都是通用:

命名

  • 不要用语言不明的缩写,不用担忧名字过长,名字必定要让别人知道确切的意思;
  • 类、类型、变量用名词或组合名词。如Member, ProductInfo;
  • 函数名用动词或者动宾组合词来表示,如get/set,RenderPage();
  • 布尔变量须要用is作前缀;
  • 尽可能写绝对路径;

注释

  • 注释是为了解释程序作了什么(What)或者为何这么作(Why),以及要特别注意的地方;
  • 注释不是为了解释程序如何工做的(How);
  • 最高境界:程序自己就应该能说明,若是程序须要额外的注释,那说明这段代码写的很烂;
//通常注释
------------------------------------------------
/*
 *
方法注释
*/

Pascal - 全部单词的首字母都大写;
Camel - 第一个单词首字母小写,其余单词首字母大写;javascript

HTML

  • HTML 问件的命名用Pascal【全部单词的首字母都大写 】的命名方式;
  • Class命名用小写字母连字符(-)来链接命名的不一样单词;
  • ID命名用小写字母连字符(-)来链接命名的不一样单词;

CSS

.ui-list{}

#btn-open-main-page{}
  • css/less文件名用连字符(-)来链接不一样单词。
  • 样式用连字符(-)来链接命名的不一样单词。
  • 从外部文件加载css,尽量减小文件数。加载标签放在文件的head部分;
  • 页面中少许的样式放在head的style标签内,大量的样式能够提取到外部的css文件中,不要使用内联式样式;
  • 编写性能优化的选择器。避免使用开销大的CSS选择器,好比*;

JavaScript

  • js文件的命名,用连字符(-)来链接文件名中的不一样单词。如user-handler.js
  • 将99%的代码放在外部js文件中,放在</body>的前边,让页面的性能最大化;
  • 属性,方法均采用Camel【全部单词的首字母都大写】形式;
  • 对象的构造函数(var变量)采用Pascal【第一个单词首字母小写,其余单词首字母大写】形式;
var globalVariable = 'I am Global Variable';
function Person(name,age) {
  this.name = name;
  this.age = age;
  this.sayHi = function() {
    console.log('Hi, I am ' + this.name + ' ' + this.age + ' years old.');
  }
}

images命名:

  • 用小写字母和连字符(-)来链接命名的不一样单词。

【参考】css


纯属我的观点,仅供参考git

相关文章
相关标签/搜索