html 规范
1. 尽量减少标签层级;
2. 双标签必须闭合,单标签用斜线闭合;
3. html第一行统一使用html5标准<!doctype html>;
4.注意代码加注释,增加可读性,如:
<!--内容--> <div class="content"> <p>content</p> </div>
5. 代码缩进统一用4 空格;
参考:http://www.runoob.com/w3cnote/front-end-standards.html
- class类: 小写字母,'-'分割;
- 图片: 小写字母,‘-’或者‘_’ 分割;
- 避免选择器嵌套层级过多,少于3级;
- 不要随意使用id,id应该按需使用,而不能滥用;
- 使用css缩写属性 ,比如padding:0 10px 5px 5px等等,这样精简代码同时又能提高用户的阅读体验;
- 不缩写单词,除非一看就明白的单词
- px像素(pixel),相对长度单位,像素px是相对于显示器屏幕分辨率而言的。
- em是相对长度单位。相对于当前对象内文本的字体尺寸。如当前对行内文本的字体尺寸未被人为设置,则相对于浏览器的默认字体尺寸。
- rem也是相对长度单位,但相对的只是html根元素。
- vw代表视窗(viewport)的宽度为1%,如果视窗宽度为1000px,那么50vw = 500px。
- vh代表窗口高度的百分,如果视窗高度为800px,那么50vh = 400px
(1)页面结构
(2)导航
(3)功能
(1)颜色:使用颜色的名称或者16进制代码
(2)字体大小,直接使用”font+字体大小”作为名称
(3)对齐样式,使用对齐目标的英文名称,如
(4)标题栏样式,使用”类别+功能”的方式命名,如
命名方法:小驼峰式命名
命名规范:前缀应当是名词。(函数的名字前缀为动词,以此区分变量和函数)
示例
var maxcount = 10; var tabletitle = 'logintable';
js 函数命名
命名方法:小驼峰式命名法
命名规范:前缀应当为动词
命名建议:可使用常见动词约定
动词 | 含义 | 返回值 |
can | 判断是否可执行某个动作(权限) | 函数返回一个布尔值。true:可执行;false:不可执行 |
has | 判断是否含有某个值 | 函数返回一个布尔值。true:含有此值;false:不含有此值 |
is | 判断是否为某个值 | 函数返回一个布尔值。true:为某个值;false:不为某个值 |
get | 获取某个值 | 函数返回一个非布尔值 |
set | 设置某个值 | 无返回值、返回是否设置成功或者返回链式对象 |
load | 加载某些数据 | 无返回值或者返回是否加载完成的结果 |
js 常量命名
命名方法:名称全部大写
命名规范:使用大写字母和下划线来组合命名,下划线用以分割单词
示例
var max_count = 10; var url = 'http://www.runoob.com';
js 文件命名
使用短线(-)或句点(.)作为分隔符号,推荐使用句点,最好使用小写英文字符,不要使用其他符号和扩展字符,如 jquery ui 1.9.0 的源文件可命名为"jquery-ui-1.9.0.js"
使用 .js 扩展名,这个扩展名的兼容性最好。其实任何扩展名都可以,只要是 text 类型、编码正确即可
用句点分隔表示名称中的从属关系,范围大的在前,如jquery 的表单插件 form既可以命名为jquery.form.js
js注释格式
使用多行注释,以/*开头,*/结尾
js 注意事项
书写格式
1. 尽量减少标签层级;
2. 双标签必须闭合,单标签用斜线闭合;
3. html第一行统一使用html5标准<!doctype html>;
4.注意代码加注释,增加可读性,如:
<!--内容--> <div class="content"> <p>content</p> </div>
5. 代码缩进统一用4 空格;
参考:http://www.runoob.com/w3cnote/front-end-standards.html