规范

sublime注释插件与javascript注释规范

前言

代码中注释是不可少的，即使是自己写的代码，过了一段时间之后再重看，如果没有注释记录的话，可能会想不到当初是这样实现的，尤其是在业务逻辑比较复杂的项目，注释变得尤为重要。怎么优雅的写有用的注释呢？

Sublime注释插件-DocBlockr

功能

生成优美注释

简介

标准的注释，包括函数名、参数、返回值等，并以多行显示，省去手动编写

wiki

使用方法

1.快速注释：输入/*、/**（在Coffee-Script中是###*），Enter 查看全文

2015/06 14 周日

Node编码规范

编码规范

缩进，2 个 space，tab要转换成 2 space. (入乡随俗，这是Node 源码及module 采用的标准) Eclipse设置
永远用 var 声明变量，不加 var 时，会污染顶层上下文
操作符与操作算子之间要有空格

Right：

1	var string = 'Foo' + bar;

Wrong:

1	var string = 'Foo'+bar;

使用string 时，用单引号替代双引号（写JSON 时除外）

Right：

var foo = 'bar';

var http = require('http');

查看全文

2015/02 06 周五

网酷前端性能优化相关编码规范

前言

本文主要介绍在使用HTML、CSS、JS的过程中，需要注意的编码细节和规范。

一、css编码规范

1.避免使用css表达式

如IE6兼容position:fixed的写法，CSS中 left:expression(eval(document.documentElement.scrollLeft+50)) 距左边50像素

2.选择使用而不是@import

在IE中，使用@import相当于将放在页面底部。

3.避免使用Filter

使用filter的问题是它会阻塞渲染并且当浏览在加载图片时，会冻结浏览器。它也会提升内存消耗，它是作用于一个元素而不是一个图片，所以问题会更严重。

最好的解决方案是完全避免使用AlphaImageLoader，用PNG8来代替。

4.css选择符

css选择符的编写方式决定了浏览器必须执行的匹配次数，而某些类型的css选择符将会导致浏览器尝试更多匹配，因此开销比简单选择符更高。查看全文

2014/11 15 周六

网酷前端性能优化点

前言

本文档为网酷前端规范系列，主要介绍前端性能优化点

一、HTTP优化

1. 减少HTTP请求

合并文件，例如css代码和js代码分别合并到一个css文件和js文件中;
使用css sprite，详细请参考css优化中的css sprite部分。
使用base64技术

2. 重定向优化

消除没必要的跳转
利用服务器重写用户键入的链接
使用HTTP而不是js或者meta来重定向

查看全文

2014/11 12 周三

网酷前端javascript规范文档

前言

本文档为网酷前端JS规范，可根据需求进行改变

一、规范目的

为提高团队协作效率，便于前端后期优化维护，输出高质量的文档。

二、基本准则

符合web标准，结构表现行为分离，兼容性优良。页面性能方面，代码要求简洁明了有序，尽可能的减小服务器负载，保证最快的解析速度。
项目的维护和二次开发可能是直接或间接的团队合作，所以创建易维护的代码是一个项目成功与否的关键，易维护的代码意味着具有如下特性：
- 阅读性好：如良好的注释和命名规范，有文档
- 具有一致性：看起来如同一个人编写
- 代码的松耦合，高度模块化：将页面内的元素视为一个个模块，相互独立，尽量避免耦合过高的代码，从html,css,js三个层面都要考虑模块化
- 严格按照规范编写代码