一个好的程序员肯定是要能书写可维护的代码,而不是一次性的代码,怎么能让团队当中其他人甚至一段时间时候你再看你某个时候写的代码也能看懂呢,这就需要规范你的代码了。
我是有一点强迫症的人,上周我们后端给我了一个CanUsename的接口(该接口的目的是判断输入的目的地是否是4级目的地),我真的是崩溃的。
我只是觉得这个名字不够语义化,但是让我自己想一个名字我又想不出来,于是我就在想,如果有一套命名规范的话,那么以后起名字就不用发愁了,直接按照规范来就好了~
于是端午在家就百度了一下~

命名

驼峰式命名法介绍

  • Pascal Case 大驼峰式命名法:首字母大写。eg:StudentInfo、UserInfo、ProductInfo

  • Camel Case 小驼峰式命名法:首字母小写。eg:studentInfo、userInfo、productInfo

文件资源命名

  • 文件名不得含有空格

  • 文件名建议只使用小写字母,不使用大写字母。( 为了醒目,某些说明文件的文件名,可以使用大写字母,比如README、LICENSE。 )

  • 文件名包含多个单词时,单词之间建议使用半角的连词线 ( – ) 分隔。

  • 引入资源使用相对路径,不要指定资源所带的具体协议 ( http:,https: ) ,除非这两者协议都不可用。

不推荐:

HTML 代码:
  1. <script src="http://cdn.com/foundation.min.js"></script>

推荐

HTML 代码:
  1. <script src="//cdn.com/foundation.min.js"></script>

变量命名

命名方式 : 小驼峰式命名方法
命名规范 : 类型+对象描述的方式,如果没有明确的类型,就可以使前缀为名词

类型 小写字母
array a
boolean b
function fn
int i
object o
regular r
string s

推荐

JavaScript 代码:
  1. var tableTitle = "LoginTable"

不推荐

JavaScript 代码:
  1. var getTitle = "LoginTable"

函数

命名方式 : 小驼峰方式 ( 构造函数使用大驼峰命名法 )
命名规则 : 前缀为动词

动词 含义 返回值
can 判断是否可执行某个动作 ( 权限 ) 函数返回一个布尔值。true:可执行;false:不可执行
has 判断是否含有某个值 函数返回一个布尔值。true:含有此值;false:不含有此值
is 判断是否为某个值 函数返回一个布尔值。true:为某个值;false:不为某个值
get 获取某个值 函数返回一个非布尔值
set 设置某个值 无返回值、返回是否设置成功或者返回链式对象

推荐:

JavaScript 代码:
  1. //是否可阅读

  2. function canRead(){

  3. return true;

  4. }

  5. //获取姓名

  6. function getName{

  7. return this.name

  8. }

常量

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

JavaScript 代码:
  1. var MAX_COUNT = 10;

  2. var URL = 'http://www.baidu.com';

类的成员

  • 公共属性和方法 : 同变量命名方式

  • 私有属性和方法 : 前缀为下划线(_)后面跟公共属性和方法一样的命名方式

推荐(将name换成this是不是更熟悉了呢)

JavaScript 代码:
  1. function Student(name) {

  2. var _name = name; // 私有成员

  3. // 公共方法

  4. this.getName = function () {

  5. return _name;

  6. }

  7. // 公共方式

  8. this.setName = function (value) {

  9. _name = value;

  10. }

  11. }

  12. var st = new Student('tom');

  13. st.setName('jerry');

  14. console.log(st.getName()); // => jerry:输出_name私有变量的值

注释规范

单行注释 ( // )

  • 单独一行://(双斜线)与注释文字之间保留一个空格

  • 在代码后面添加注释://(双斜线)与代码之间保留一个空格,并且//(双斜线)与注释文字之间保留一个空格。

  • 注释代码://(双斜线)与代码之间保留一个空格。

推荐 :

JavaScript 代码:
  1. // 调用了一个函数;1)单独在一行

  2. setTitle();

  3. var maxCount = 10; // 设置最大量;2)在代码后面注释

  4. // setName(); // 3)注释代码

多行注释 ( / 注释说明 / )

  • 若开始(/*和结束(*/)都在一行,推荐采用单行注释

  • 若至少三行注释时,第一行为/*,最后行为*/,其他行以*开始,并且注释文字与*保留一个空格。

推荐 :

JavaScript 代码:
  1. /*

  2. * 代码执行到这里后会调用setTitle()函数

  3. * setTitle():设置title的值

  4. */

  5. setTitle();

函数 ( 方法 ) 注释

函数(方法)注释也是多行注释的一种,但是包含了特殊的注释要求,参照 javadoc(百度百科)

语法:

JavaScript 代码:
  1. /**

  2. * 函数说明

  3. * @关键字

  4. */

常用注释关键字

注释名 语法 含义 示例
@param @param 参数名 {参数类型} 描述信息 描述参数的信息 @param name {String} 传入名称
@return @return {返回类型} 描述信息 描述返回值的信息 @return {Boolean} true:可执行;false:不可执行
@author @author 作者信息 [附属信息:如邮箱、日期] 描述此函数作者的信息 @author 张三 2015/07/21
@version @version XX.XX.XX 描述此函数的版本号 @version 1.0.3
@example @example 示例代码 @example setTitle(‘测试’) 如下

推荐 :

JavaScript 代码:
  1. /**

  2. - 合并Grid的行

  3. - @param grid {Ext.Grid.Panel} 需要合并的Grid

  4. - @param cols {Array} 需要合并列的Index(序号)数组;从0开始计数,序号也包含。

  5. - @param isAllSome {Boolean} :是否2个tr的cols必须完成一样才能进行合并。true:完成一样;false(默认):不完全一样

  6. - @return void

  7. - @author polk6 2015/07/21

  8. - @example

  9. - _________________                             _________________

  10. - |  年龄 |  姓名 |                             |  年龄 |  姓名 |

  11. - -----------------      mergeCells(grid,[0])   -----------------

  12. - |  18   |  张三 |              =>             |       |  张三 |

  13. - -----------------                             -  18   ---------

  14. - |  18   |  王五 |                             |       |  王五 |

  15. - -----------------                             -----------------

  16. */

  17. function mergeCells(grid, cols, isAllSome) {

  18. // Do Something

  19. }

愚人码头注:推荐使用 JSDOC 或者 ESDOC

HTML规范

文档规范

使用 HTML5 的文档声明类型 : <!DOCTYPE html>

  • DOCTYPE标签是一种标准通用标记语言的文档类型声明,它的目的是要告诉标准通用标记语言解析器,它应该使用什么样的文档类型定义(DTD)来解析文档。

  • 使用文档声明类型的作用是为了防止开启浏览器的怪异模式。

  • 没有DOCTYPE文档类型声明会开启浏览器的怪异模式,浏览器会按照自己的解析方式渲染页面,在不同的浏览器下面会有不同的样式。

  • 如果你的页面添加了<!DOCTYP>那么,那么就等同于开启了标准模式。浏览器会按照W3C标准解析渲染页面。

脚本加载

说到js和css的位置,大家应该都知道js放在下面,css放在上面。
但是,如果你的项目只需要兼容ie10+或者只是在移动端访问,那么可以使用HTML5的新属性async,将脚本文件放在<head>
兼容老旧浏览器(IE9-)时
脚本引用写在 body 结束标签之前,并带上 async 属性。这虽然在老旧浏览器中不会异步加载脚本,但它只阻塞了 body 结束标签之前的 DOM 解析,这就大大降低了其阻塞影响。
而在现代浏览器中
脚本将在 DOM 解析器发现 body 尾部的 script 标签才进行加载,此时加载属于异步加载,不会阻塞 CSSOM(但其执行仍发生在 CSSOM 之后)。
综上所述,
所有浏览器中推荐:

HTML 代码:
  1. <html>

  2. <head>

  3. <link rel="stylesheet" href="main.css">

  4. </head>

  5. <body>

  6. <!-- body goes here -->

  7. <script src="main.js" async></script>

  8. </body>

  9. </html>

只兼容现代浏览器推荐:

HTML 代码:
  1. <html>

  2. <head>

  3. <link rel="stylesheet" href="main.css">

  4. <script src="main.js" async></script>

  5. </head>

  6. <body>

  7. <!-- body goes here -->

  8. </body>

  9. </html>

语义化

我们一直都在说语义化编程,语义化编程,但是在代码中很少有人完全使用正确的元素。使用语义化标签也是有理由SEO的。

语义化是指:根据元素其被创造出来时的初始意义来使用它。
意思就是用正确的标签干正确的事,而不是只有divspan

不推荐:

HTML 代码:
  1. <b>My page title</b>

  2. <div class="top-navigation">

  3. <div class="nav-item"><a href="#home">Home</a></div>

  4. <div class="nav-item"><a href="#news">News</a></div>

  5. <div class="nav-item"><a href="#about">About</a></div>

  6. </div>

  7. <div class="news-page">

  8. <div class="page-section news">

  9. <div class="title">All news articles</div>

  10. <div class="news-article">

  11. <h2>Bad article</h2>

  12. <div class="intro">Introduction sub-title</div>

  13. <div class="content">This is a very bad example for HTML semantics</div>

  14. <div class="article-side-notes">I think I'm more on the side and should not receive the main credits</div>

  15. <div class="article-foot-notes">

  16. This article was created by David <div class="time">2014-01-01 00:00</div>

  17. </div>

  18. </div>

  19. <div class="section-footer">

  20. Related sections: Events, Public holidays

  21. </div>

  22. </div>

  23. </div>

  24. <div class="page-footer">

  25. Copyright 2014

  26. </div>

推荐

HTML 代码:
  1. <!-- The page header should go into a header element -->

  2. <header>

  3. <!-- As this title belongs to the page structure it's a heading and h1 should be used -->

  4. <h1>My page title</h1>

  5. </header>

  6. <!-- All navigation should go into a nav element -->

  7. <nav class="top-navigation">

  8. <!-- A listing of elements should always go to UL (OL for ordered listings) -->

  9. <ul>

  10. <li class="nav-item"><a href="#home">Home</a></li>

  11. <li class="nav-item"><a href="#news">News</a></li>

  12. <li class="nav-item"><a href="#about">About</a></li>

  13. </ul>

  14. </nav>

  15. <!-- The main part of the page should go into a main element (also use role="main" for accessibility) -->

  16. <main class="news-page" role="main">

  17. <!-- A section of a page should go into a section element. Divide a page into sections with semantic elements. -->

  18. <section class="page-section news">

  19. <!-- A section header should go into a section element -->

  20. <header>

  21. <!-- As a page section belongs to the page structure heading elements should be used (in this case h2) -->

  22. <h2 class="title">All news articles</h2>

  23. </header>

  24. <!-- If a section / module can be seen as an article (news article, blog entry, products teaser, any other

  25. re-usable module / section that can occur multiple times on a page) a article element should be used -->

  26. <article class="news-article">

  27. <!-- An article can contain a header that contains the summary / introduction information of the article -->

  28. <header>

  29. <!-- As a article title does not belong to the overall page structure there should not be any heading tag! -->

  30. <div class="article-title">Good article</div>

  31. <!-- Small can optionally be used to reduce importance -->

  32. <small class="intro">Introduction sub-title</small>

  33. </header>

  34. <!-- For the main content in a section or article there is no semantic element -->

  35. <div class="content">

  36. <p>This is a good example for HTML semantics</p>

  37. </div>

  38. <!-- For content that is represented as side note or less important information in a given context use aside -->

  39. <aside class="article-side-notes">

  40. <p>I think I'm more on the side and should not receive the main credits</p>

  41. </aside>

  42. <!-- Articles can also contain footers. If you have footnotes for an article place them into a footer element -->

  43. <footer class="article-foot-notes">

  44. <!-- The time element can be used to annotate a timestamp. Use the datetime attribute to specify ISO time

  45. while the actual text in the time element can also be more human readable / relative -->

  46. <p>This article was created by David <time datetime="2014-01-01 00:00" class="time">1 month ago</time></p>

  47. </footer>

  48. </article>

  49. <!-- In a section, footnotes or similar information can also go into a footer element -->

  50. <footer class="section-footer">

  51. <p>Related sections: Events, Public holidays</p>

  52. </footer>

  53. </section>

  54. </main>

  55. <!-- Your page footer should go into a global footer element -->

  56. <footer class="page-footer">

  57. Copyright 2014

  58. </footer>

alt标签不为空

<img>标签的 alt 属性指定了替代文本,用于在图像无法显示或者用户禁用图像显示时,代替图像显示在浏览器中的内容。
假设由于下列原因用户无法查看图像,alt 属性可以为图像提供替代的信息:

  • 网速太慢

  • src 属性中的错误

  • 浏览器禁用图像

  • 用户使用的是屏幕阅读器

从SEO角度考虑,浏览器的爬虫爬不到图片的内容,所以我们要有文字告诉爬虫图片的内容

结构、表现、行为三者分离

尽量在文档和模板中只包含结构性的 HTML;而将所有表现代码,移入样式表中;将所有动作行为,移入脚本之中。
在此之外,为使得它们之间的联系尽可能的小,在文档和模板中也尽量少地引入样式和脚本文件。
建议:

  • 不使用超过一到两张样式表

  • 不使用超过一到两个脚本(学会用合并脚本)

  • 不使用行内样式(<style>.no-good {}</style>

  • 不在元素上使用 style 属性(<hr >

  • 不使用行内脚本(<script>alert('no good')</script>

  • 不使用表象元素(i.e. <b>, <u>, <center>, <font>, <b>

  • 不使用表象 class 名(i.e. red, left, center

HTML只关注内容

  • HTML只显示展示内容信息

  • 不要引入一些特定的 HTML 结构来解决一些视觉设计问题

  • 不要将img元素当做专门用来做视觉设计的元素

  • 样式上的问题应该使用css解决

不推荐:

HTML 代码:
  1. <!-- We should not introduce an additional element just to solve a design problem  -->

  2. <span class="text-box">

  3. <span class="square"></span>

  4. See the square next to me?

  5. </span>

  6. css 代码:

  7. .text-box > .square {

  8. display: inline-block;

  9. width: 1rem;

  10. height: 1rem;

  11. background-color: red;

  12. }

推荐

HTML 代码:
  1. <!-- That's clean markup! -->

  2. <span class="text-box">

  3. See the square next to me?

  4. </span>

  5. css 代码:

  6. /* We use a :before pseudo element to solve the design problem of placing a colored square in front of the text content */

  7. .text-box:before {

  8. content: "";

  9. display: inline-block;

  10. width: 1rem;

  11. height: 1rem;

  12. background-color: red;

  13. }

图片和 SVG 图形能被引入到 HTML 中的唯一理由是它们呈现出了与内容相关的一些信息。

不推荐

HTML 代码:
  1. <!-- Content images should never be used for design elements!  -->

  2. <span class="text-box">

  3. <img src="square.svg" alt="Square" />

  4. See the square next to me?

  5. </span>

推荐

HTML 代码:
  1. <!-- That's clean markup! -->

  2. <span class="text-box">

  3. See the square next to me?

  4. </span>

  5. css 代码:

  6. /* We use a :before pseudo element with a background image to solve the problem */

  7. .text-box:before {

  8. content: "";

  9. display: inline-block;

  10. width: 1rem;

  11. height: 1rem;

  12. background: url(square.svg) no-repeat;

  13. background-size: 100%;

  14. }

js规范

避免全局命名空间污染

防止全局命名空间被污染,我们通常的做法是将代码包裹成一个 IIFE(Immediately-Invoked Function Expression),创建独立隔绝的定义域。也使得内存在执行完后立即释放。

IIFE 还可确保你的代码不会轻易被其它全局命名空间里的代码所修改(i.e. 第三方库,window 引用,被覆盖的未定义的关键字等等)。
不推荐:

JavaScript 代码:
  1. var x = 10,

  2. y = 100;

  3. // Declaring variables in the global scope is resulting in global scope pollution. All variables declared like this

  4. // will be stored in the window object. This is very unclean and needs to be avoided.

  5. console.log(window.x + ' ' + window.y);

推荐

JavaScript 代码:
  1. // We declare a IIFE and pass parameters into the function that we will use from the global space

  2. (function(log, w, undefined){

  3. 'use strict';

  4. var x = 10,

  5. y = 100;

  6. // Will output 'true true'

  7. log((w.x === undefined) + ' ' + (w.y === undefined));

  8. }(window.console.log, window));

推荐的IIFE写法:

JavaScript 代码:
  1. (function(){

  2. 'use strict';

  3. // Code goes here

  4. }());

如果你想引用全局变量或者是外层 IIFE 的变量,可以通过下列方式传参:

JavaScript 代码:
  1. (function($, w, d){

  2. 'use strict';

  3. $(function() {

  4. w.alert(d.querySelectorAll('div').length);

  5. });

  6. }(jQuery, window, document));

严格模式

ECMAScript 5 严格模式可在整个脚本或独个方法内被激活。它对应不同的 javascript 语境会做更加严格的错误检查。严格模式也确保了 javascript 代码更加的健壮,运行的也更加快速。

严格模式会阻止使用在未来很可能被引入的预留关键字。

你应该在你的脚本中启用严格模式,最好是在独立的 IIFE 中应用它。避免在你的脚本第一行使用它而导致你的所有脚本都启动了严格模式,这有可能会引发一些第三方类库的问题。

变量声明

总是使用 var 来声明变量。如不指定 var,变量将被隐式地声明为全局变量,例如

JavaScript 代码:
  1. var a = b = 0; //b会被隐式的创建为全局变量

所以,请总是使用 var 来声明变量,并且使用单var模式(将所有的变量在函数最前面只使用一个var定义)。例如:

JavaScript 代码:
  1. (function (){

  2. 'use strict'

  3. var a = 0,

  4. b = 0,

  5. c = 0,

  6. i,

  7. j,

  8. myObject();

  9. }())

采用严格模式带来的好处是,当你手误输入错误的变量名时,它可以通过报错信息来帮助你定位错误出处。

js声明提前

javascript会自动将函数作用域内的变量和方法的定义提前(只是提前声明,赋值还是在原处)
例如:

JavaScript 代码:
  1. (function(log){

  2. 'use strict';

  3. var a = 10;

  4. for(var i = 0; i < a; i++) {

  5. var b = i * i;

  6. log(b);

  7. }

  8. if(a === 10) {

  9. var f = function() {

  10. log(a);

  11. };

  12. f();

  13. }

  14. function x() {

  15. log('Mr. X!');

  16. }

  17. x();

  18. }(window.console.log));

提升后的js

JavaScript 代码:
  1. (function(log){

  2. 'use strict';

  3. // All variables used in the closure will be hoisted to the top of the function

  4. var a,

  5. i,

  6. b,

  7. f;

  8. // All functions in the closure will be hoisted to the top

  9. function x() {

  10. log('Mr. X!');

  11. }

  12. a = 10;

  13. for(i = 0; i < a; i++) {

  14. b = i * i;

  15. log(b);

  16. }

  17. if(a === 10) {

  18. // Function assignments will only result in hoisted variables but the function body will not be hoisted

  19. // Only by using a real function declaration the whole function will be hoisted with its body

  20. f = function() {

  21. log(a);

  22. };

  23. f();

  24. }

  25. x();

  26. }(window.console.log));

使用严格等

总是使用 === 精确的比较操作符,避免在判断的过程中,由 JavaScript 的强制类型转换所造成的困扰。例如:

JavaScript 代码:
  1. (function(log){

  2. 'use strict';

  3. log('0' == 0); // true

  4. log('' == false); // true

  5. log('1' == true); // true

  6. log(null == undefined); // true

  7. var x = {

  8. valueOf: function() {

  9. return 'X';

  10. }

  11. };

  12. log(x == 'X');

  13. }(window.console.log));

等同== 和严格等===的区别

  • ==, 两边值类型不同的时候,要先进行类型转换,再比较。

  • ===,不做类型转换,类型不同的一定不等。

==等同操作符

  • 如果两个值具有相同类型,会进行===比较,返回===的比较值

  • 如果两个值不具有相同类型,也有可能返回true

  • 如果一个值是null另一个值是undefined,返回true

  • 如果一个值是string另个是number,会把string转换成number再进行比较

  • 如果一个值是true,会把它转成1再比较,false会转成0

JavaScript 代码:
  1. console.log( false == null )      // false

  2. console.log( false == undefined ) // false

  3. console.log( false == 0 )         // true

  4. console.log( false == '' )        // true

  5. console.log( false == NaN )       // false

  6. console.log( null == undefined ) // true

  7. console.log( null == 0 )         // false

  8. console.log( null == '' )        // false

  9. console.log( null == NaN )       // false

  10. console.log( undefined == 0)   // false

  11. console.log( undefined == '')  // false

  12. console.log( undefined == NaN) // false

  13. console.log( 0 == '' )  // true

  14. console.log( 0 == NaN ) // false

总结一下==

  • false 除了和自身比较为 true 外,和 0,”” 比较也为 true

  • null 只和 undefined 比较时为 true, 反过来 undefined 也仅和 null 比较为 true,没有第二个

  • 0 除了和 false 比较为 true,还有空字符串 ”” 和空数组 []

  • 空字符串 ” 除了和 false 比较为 true,还有一个数字 0

==, >, <, +, -, … 这些操作符所造成的隐式类型转换都是无副作用的,它不会改变变量本身保存的值。,但是,如果你覆写某个对象的 valueOf/toString的话,==就会产生副作用.

例如:

JavaScript 代码:
  1. Array.prototype.valueOf = function() {

  2. this[0]++;

  3. return this;

  4. }

  5. var x = [1, 2, 3];

  6. x == 0;

  7. console.log(x);   // [2, 2, 3]

===操作符:

  • 要是两个值类型不同,返回false

  • 要是两个值都是number类型,并且数值相同,返回true

  • 要是两个值都是stirng,并且两个值的String内容相同,返回true

  • 要是两个值都是true或者都是false,返回true

  • 要是两个值都是指向相同的Object,Arraya或者function,返回true

  • 要是两个值都是null或者都是undefined,返回true

真假判断

  • js中以下内容为假:

  • false

  • null

  • undefined

  • 0

  • ” (空字符串)

  • NaN

设置默认参数

辑操作符 || 和 && 也可被用来返回布尔值。如果操作对象为非布尔对象,那每个表达式将会被自左向右地做真假判断。基于此操作,最终总有一个表达式被返回回来。这在变量赋值时,是可以用来简化你的代码的。例如:如果x不存在且y不存在,x=1;如果x存在y存在,x = y

JavaScript 代码:
  1. if(!x) {

  2. if(!y) {

  3. x = 1;

  4. } else {

  5. x = y;

  6. }

  7. }

等同于:

JavaScript 代码:
  1. x = x || y || 1;

这一小技巧经常用来给方法设定默认的参数。

JavaScript 代码:
  1. (function(log){

  2. 'use strict';

  3. function multiply(a, b) {

  4. a = a || 1;

  5. b = b || 1;

  6. log('Result ' + a * b);

  7. }

  8. multiply(); // Result 1

  9. multiply(10); // Result 10

  10. multiply(3, NaN); // Result 3

  11. multiply(9, 5); // Result 45

  12. }(window.console.log));

不使用eval()函数

就如eval的字面意思来说,恶魔,使用eval()函数会带来安全隐患。
eval()函数的作用是返回任意字符串,当作js代码来处理。

this关键字

只在对象构造器、方法和在设定的闭包中使用
this 关键字。this 的语义在此有些误导。它时而指向全局对象(大多数时),时而指向调用者的定义域(在 eval 中),时而指向 DOM
树中的某一节点(当用事件处理绑定到 HTML 属性上时),时而指向一个新创建的对象(在构造器中),还时而指向其它的一些对象(如果函数被
call() 和 apply() 执行和调用时)。

正因为它是如此容易地被搞错,请限制它的使用场景:

  • 在构造函数中

  • 在对象的方法中(包括由此创建出的闭包内)

首选函数式风格

函数式编程让你可以简化代码并缩减维护成本,因为它容易复用,又适当地解耦和更少的依赖。

接下来的例子中,在一组数字求和的同一问题上,比较了两种解决方案。第一个例子是经典的程序处理,而第二个例子则是采用了函数式编程和 ECMA Script 5.1 的数组方法。
不推荐

JavaScript 代码:
  1. (function(log){

  2. 'use strict';

  3. var arr = [10, 3, 7, 9, 100, 20],

  4. sum = 0,

  5. i;

  6. for(i = 0; i < arr.length; i++) {

  7. sum += arr[i];

  8. }

  9. log('The sum of array ' + arr + ' is: ' + sum)

  10. }(window.console.log));

推荐(函数式编程):

JavaScript 代码:
  1. (function(log){

  2. 'use strict';

  3. var arr = [10, 3, 7, 9, 100, 20];

  4. var sum = arr.reduce(function(prevValue, currentValue) {

  5. return prevValue + currentValue;

  6. }, 0);

  7. log('The sum of array ' + arr + ' is: ' + sum);

  8. }(window.console.log));

修改内建对象的原型链

修改内建的诸如 Object.prototype 和 Array.prototype 是被严厉禁止的。修改其它的内建对象比如 Function.prototype,虽危害没那么大,但始终还是会导致在开发过程中难以 debug 的问题,应当也要避免。

三元条件判断(if 的快捷方法)

用三元操作符分配或返回语句。在比较简单的情况下使用,避免在复杂的情况下使用。没人愿意用 10 行三元操作符把自己的脑子绕晕。
不推荐:

JavaScript 代码:
  1. if(x === 10) {

  2. return 'valid';

  3. } else {

  4. return 'invalid';

  5. }

推荐:

JavaScript 代码:
  1. return x === 10 ? 'valid' : 'invalid'

JSHint

在js规范中,有很多规范都是样式上的规范而不是逻辑上的规范,比如尽量使用===而不是==,我们可以使用JSHint或者JSLint,Javascript代码验证工具,这种工具可以检查你的代码并提供相关的代码改进意见。我个人使用的是JSHint,所以就以这个为例

webstorm内置JSHint

对于ws爱好者来说,我没有用过其他的编译器,ws基本上能满足你的所有需求(最新的ws集成了vue)。
在Settings => language & frameworks => JavaScript => Code Quality Tolls => JSHint

webstorm中的jshint

这些规范都是什么意思呢,这里列出一些常用的,剩下的大家可以参考官方文档

名称 含义
curly 循环或者条件语句必须使用花括号包住
eqeqeq 使用强制等===
newcap 对于首字母大写的函数(声明的类),强制使用new
noarg 禁用arguments.caller和arguments.callee
sub 对于属性使用aaa.bbb而不是aaa[‘bbb’]
undef 查找所有未定义的变量
boss 查找类似与if(a = 0)这样的代码
node 指定运行环境为node
strict 必须使用严格模式
asi 允许省略分号
bitwise 禁止使用位运算符,比如经常把&&写错& 规避此错误
jquery 定义全局暴露的jQuery库
evil 禁止使用eval
maxdepth 嵌套的最大深度
maxparams 参数的最大个数

css规范

id和class的命名

ID和class的名称总是使用可以反应元素目的和用途的名称,或其他通用的名称,代替表象和晦涩难懂的名称
不推荐 :

CSS 代码:
  1. .fw-800 {

  2. font-weight: 800;

  3. }

  4. .red {

  5. color: red;

  6. }

推荐 :

CSS 代码:
  1. .heavy {

  2. font-weight: 800;

  3. }

  4. .important {

  5. color: red;

  6. }

合理的使用ID

一般情况下ID不应该被用于样式,并且ID的权重很高,所以不使用ID解决样式的问题,而是使用class
不推荐:

CSS 代码:
  1. #content .title {

  2. font-size: 2em;

  3. }

推荐:

CSS 代码:
  1. .content .title {

  2. font-size: 2em;

  3. }

css选择器中避免使用标签名

从结构、表现、行为分离的原则来看,应该尽量避免css中出现HTML标签,并且在css选择器中出现标签名会存在潜在的问题。

使用子选择器

很多前端开发人员写选择器链的时候不使用 直接子选择器(注:直接子选择器和后代选择器的区别)。
有时,这可能会导致疼痛的设计问题并且有时候可能会很耗性能。
然而,在任何情况下,这是一个非常不好的做法。
如果你不写很通用的,需要匹配到DOM末端的选择器, 你应该总是考虑直接子选择器。
不推荐:

CSS 代码:
  1. .content .title {

  2. font-size: 2rem;

  3. }

推荐

JavaScript 代码:
  1. .content > .title {

  2. font-size: 2rem;

  3. }

尽量使用缩写属性

尽量使用缩写属性对于代码效率和可读性是很有用的,比如font属性。
不推荐:

CSS 代码:
  1. border-top-style: none;

  2. font-family: palatino, georgia, serif;

  3. font-size: 100%;

  4. line-height: 1.6;

  5. padding-bottom: 2em;

  6. padding-left: 1em;

  7. padding-right: 1em;

  8. padding-top: 0;

推荐:

CSS 代码:
  1. border-top: 0;

  2. font: 100%/1.6 palatino, georgia, serif;

  3. padding: 0 1em 2em;

0后面不带单位

省略0后面的单位,
不推荐:

CSS 代码:
  1. padding-bottom: 0px;

  2. margin: 0em;

推荐:

JavaScript 代码:
  1. padding-bottom: 0;

  2. margin: 0;

属性格式

  • 为了保证一致性和可扩展性,每个声明应该用分号结束,每个声明换行。

  • 属性名的冒号后使用一个空格。出于一致性的原因,
    属性和值(但属性和冒号之间没有空格)的之间始终使用一个空格。

  • 每个选择器和属性声明总是使用新的一行。

  • 属性选择器或属性值用双引号(””),而不是单引号(”)括起来。

  • URI值(url())不要使用引号。

作为最佳实践,我们应该遵循以下顺序(应该按照下表的顺序):

结构性属性:

  1. display

  2. position, left, top, right etc.

  3. overflow, float, clear etc.

  4. margin, padding

表现性属性:

  • background, border etc.

  • font, text

不推荐:

CSS 代码:
  1. .box {

  2. font-family: 'Arial', sans-serif;

  3. border: 3px solid #ddd;

  4. left: 30%;

  5. position: absolute;

  6. text-transform: uppercase;

  7. background-color: #eee;

  8. right: 30%;

  9. isplay: block;

  10. font-size: 1.5rem;

  11. overflow: hidden;

  12. padding: 1em;

  13. margin: 1em;

  14. }

推荐:

CSS 代码:
    1. .box {

    2. display: block;

    3. position: absolute;

    4. left: 30%;

    5. right: 30%;

    6. overflow: hidden;

    7. margin: 1em;

    8. padding: 1em;

    9. background-color: #eee;

    10. border: 3px solid #ddd;

    11. font-family: 'Arial', sans-serif;

    12. font-size: 1.5rem;

    13. text-transform: uppercase;

    14. }

前端开发规范:命名规范、HTML 规范、CSS 规范、JavaScript 规范的更多相关文章

  1. 前端开发【第2篇:CSS】

    鸡血 样式的属性多达几千个,但别担心,按照80-20原则,常用的也就几十个,你完全可以掌握它. Css初识 HTML的诞生 早期只有HTML的时候为了让HTML更美观一点,当时页面的开发者会把颜色写到 ...

  2. Front End Developer Questions 前端开发人员问题(二)CSS 后续

    问题来源:http://markyun.github.io/2015/Front-end-Developer-Questions/ 31.视差滚动效果,如何给每页做不同的动画?(回到顶部,向下滑动要再 ...

  3. web前端开发常用的几种图片格式及其使用规范

    首先,在正式说图片格式之前,咱们先说一些额外的东西. 矢量图与位图 矢量图是通过组成图形的一些基本元素,如点.线.面,边框,填充色等信息通过计算的方式来显示图形的.一般来说矢量图表示的是几何图形,文件 ...

  4. 如何结合整洁架构和MVP模式提升前端开发体验(三) - 项目工程化配置、规范篇

    工程化配置 还是开发体验的问题,跟开发体验有关的项目配置无非就是使用 eslint.prettier.stylelint 统一代码风格. formatting and lint eslint.pret ...

  5. Web前端开发基础 第四课(CSS元素模型)

    css布局模型 清楚了CSS 盒模型的基本概念. 盒模型类型, 我们就可以深入探讨网页布局的基本模型了.布局模型与盒模型一样都是 CSS 最基本. 最核心的概念. 但布局模型是建立在盒模型基础之上,又 ...

  6. Web前端开发基础 第四课(CSS小技巧1)

    垂直居中-父元素高度确定的单行文本 父元素高度确定的单行文本的竖直居中的方法是通过设置父元素的 height 和 line-height 高度一致来实现的.如下代码: <div class=&q ...

  7. Web前端开发基础 第四课(CSS小技巧)

    水平居中设置-行内元素 我们在实际工作中常会遇到需要设置水平居中场景,今天我们就来看看怎么设置水平居中的. 如果被设置元素为文本.图片等行内元素时,水平居中是通过给父元素设置 text-align:c ...

  8. Web前端开发基础 第四课(CSS元素分类)

    元素分类 在讲解CSS布局之前,我们需要提前知道一些知识,在CSS中,html中的标签元素大体被分为三种不同的类型:块状元素.内联元素(又叫行内元素)和内联块状元素. 常用的块状元素有: <di ...

  9. Web前端开发基础 第四课(CSS文字和段落排版)

    文字排版--字体 我们可以使用css样式为网页中的文字设置字体.字号.颜色等样式属性.下面我们来看一个例子,下面代码实现:为网页中的文字设置字体为宋体. body{font-family:" ...

  10. Web前端开发基础 第四课(CSS一些性质)

    继承 CSS的某些样式是具有继承性的,那么什么是继承呢?继承是一种规则,它允许样式不仅应用于某个特定html标签元素,而且应用于其后代.比如下面代码:如某种颜色应用于p标签,这个颜色设置不仅应用p标签 ...

随机推荐

  1. DAO工具类的封装源码

    详细源码见下表,绝对原创,转载请注明出处! package com.ydj.util; import java.sql.Connection; import java.sql.PreparedStat ...

  2. Hystrix【参数配置及缓存】

    1.常用参数说明 hystrix参数的详细配置可参照 https://github.com/Netflix/Hystrix/wiki/Configuration 下面是一些常用的配置: 配置项 默认值 ...

  3. SQL——UPDATE(改)

    一.UPDATE语句基本用法 UPADTE语句用于修改表中已存在的记录. UPDATE语句语法: UPDATE 表名 SET 列名1 = 值1,列名2 = 值2... WHERE 条件语句; 演示st ...

  4. PAT甲级题分类汇编——序言

    今天开个坑,分类整理PAT甲级题目(https://pintia.cn/problem-sets/994805342720868352/problems/type/7)中1051~1100部分.语言是 ...

  5. nginx与php配置用户问题

    当配置nginx的nginx.conf 时,可参照如下配置: server { listen 80; server_name www.advancephp2017.com; access_log lo ...

  6. 记录MindSphere On Cloud Foundry的一次尝试过程

    试验背景: 开始时间:2019年12月11日 结束时间:2019年12月13日 自己编写一个后台程序,尝试推送到Cloud Foundry上,并开放从MindSphere以外访问的权限. 程序实现以下 ...

  7. 第2章 NIO入门

    2.1 传统的BIO编程 以服务器为例,在传统BIO模型下的服务器,每当一个新的请求到来的时候回分配一个线程去处理该请求,并且该线程在执行IO操作的时候会一直阻塞,知道IO操作完成或抛出异常才会返回. ...

  8. 路由基础(Routing)

    查看本机路由表: [root@controller02 ~]# cat /etc/iproute2/rt_tables # # reserved values # 255     local 254  ...

  9. 本地安装SQL Server 2017 Express和Microsoft SQL Server Management Studio 18.1

    sqlserver下载链接:https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 这个安装的是免费版的Express,当然也可 ...

  10. [JZOJ5280]膜法师题解--思维+前缀和

    [JZOJ5280]膜法师题解--思维+前缀和 题目链接 暴 力 过 于