书写原则

半个月过去,觉得自己学得挺快的。最好的提升就是实践。不像以前的应试学习,理论值满分,实践值为20%不到。

在实践中,慢慢得发现自己过去一些不好的习惯,一点点纠正。就像人的一生,年轻的时候,容许很多错误,但是一旦一个人强大了,要承载的事物变多变沉重了,犯错的机会就越来越少。这就需要年轻时候犯错,教训、反思和成长。我想,在一些小的项目或是自己的联系中,多多总结、改善,迎接大的项目的到来。我想,一个从未犯过错的人,永远都不能深刻体会到其中的代价。

最近改变最大的就是书写规范。
原则就是那句:不管有多少人共同参与同一项目,一定要确保每一行代码都像是同一个人编写的。


HTML&CSS书写原则

目前参考的是:编码规范 by @mdo

其他:NEC

这里特别总结下自己在这方面最近学到的:

1、用两个空格来代替制表符(tab) — 这是唯一能保证在所有环境下获得一致展现的方法。嵌套元素应当缩进一次(即两个空格)。

现在用sublime text3,默认情况下是Tab(制表符),但是不同编辑器、,对Tab的支持不一致。所以要将Tab转换成用空格,用两个空格代替制表符。

转换方法:sublime 设置空格缩进配置

2、根据 HTML5 规范,在引入 CSS 和 JavaScript 文件时一般不需要指定 type 属性,因为 text/css 和 text/javascript 分别是它们的默认值。

3、HTML属性顺序

确保代码读性。

  • <code style="color: #d44950;">class
  • <code style="color: #d44950;">id<code style="color: #d44950;">name
  • <code style="color: #d44950;">data-*
  • <code style="color: #d44950;">src<code style="color: #d44950;">for<code style="color: #d44950;">type<code style="color: #d44950;">href
  • <code style="color: #d44950;">title<code style="color: #d44950;">alt
  • <code style="color: #d44950;">aria-*<code style="color: #d44950;">role

4、为了代码的易读性,在每个声明块的左花括号前添加一个空格。

5、每条声明语句的 : 后应该插入一个空格。

6、对于属性值或颜色参数,省略小于 1 的小数前面的 0 (例如,.5 代替 0.5;-.5px 代替 -0.5px)。

7、CSS声明顺序

  1. Positioning
  2. Box model
  3. Typographic
  4. Visual

8、CSS命名

区分CSS和JS命名,CSS用-,JS用_。

更加语义化。

链接:CSS命名规范

9、注释要一致,明白注释的用途。

10、带前缀的属性

通过缩进的方式,让每个属性的值在垂直方向对其,这样便于多行编辑。


JS书写原则

1、变量:建议驼峰式,常量:全部大写,类:首字母大写的驼峰式

如果用sublime的话,可以用一个插件CSScomb.js,具体看:Sublime插件学习
但一切都是为了团队,以团队的标准为主。

还有很多很多,都需要平时养成良好习惯,不断纠错、积累。

链接:idiomatic.js

麻凯倩

微信:makaiqian