原文地址:http://kissyteam.github.com/docs/html/styleguide/common-conventions.html
文件与目录命名约定
-
一律小写,必须是英文单词或产品名称的拼音,多个单词用连字符(-)连接。 只能出现英文字母、数字和连字符,严禁出现中文。
- 出现版本号时,需要用字母 v 做为前缀,小版本号用点号(.)隔开,比如 global-v8.js 或 detail-v2.2.js 。
- 该命名规范适用于 html, css, js, swf, php, xml, png, gif, jpg, ico 等前端维护的所有文件类型和相关目录。
- js 和 css 压缩文件,统一以 -min 结尾,比如源码文件为 kissy.js,压缩后为 kissy-min.js 。
文件编码约定
由于历史原因,前端开发涉及的所有文本文件请统一 采用 GB2312, GBK 或 GB18030 编码 。
注意:后台采用 UTF-8 的新项目,或自主开发的项目,推荐使用 UTF-8 编码。
id 和 class 命名约定
- id 和 class 的命名总规则为: 内容优先,表现为辅 。首先根据内容来命名,比如 main-nav. 如果根据内容找不到合适的命名,可以再结合表现来定,比如 skin-blue, present-tab, col-main.
- id 和 class 名称一律小写,多个单词用连字符连接,比如 recommend-presents.
- id 和 class 名称中只能出现小写的 26 个英文字母、数字和连字符(-),任何其它字符都严禁出现。
- id 和 class 尽量用英文单词命名 。确实找不到合适的单词时,可以考虑使用产品的中文拼音,比如 wangwang, dating. 对于中国以及淘宝特色词汇,也可以使用拼音,比如 xiaobao, daigou. 除了产品名称和特色词汇,其它任何情况下都严禁使用拼音。
- 在不影响语义的情况下,id 和 class 名称中可以适当采用英文单词缩写,比如 col, nav, hd, bd, ft 等,但切忌自造缩写。
- id 和 class 名称中的第一个词必须是单词全拼或语义非常清晰的单词缩写,比如 present, col.
- 仅在 JavaScript 代码中当作 hook 用的 id 或 class, 命名规则为 J_UpperCamelCase(请注意,J_ 后的首字母也大写!), 其中字母 J 代表 JavaScript, 也是钩子(hook)的象形。注意:如果在 JavaScript 和 CSS 中都需要用到,则不用遵守本约定。
- 在自动化测试脚本中当作 hook 用的 class, 命名规则为 T_UpperCamelCase, 其中字母 T 代表 Test.
分享到:
相关推荐
适合初级前端开发工程师转正述职的ppt报告模版,前端开发,述职报告,前端开发述职报告,ppt模版,ppt报告模版,述职报告ppt模版,前端开发述职报告ppt模版,转正,转正报告,转正报告模版,转正报告ppt模版,转正...
阿里前端开发规范.pdf
阿里web前端开发手册.pdf
04前端开发基础视频-操作系统通用快捷键操作(1)win快捷键使用.avi 05前端开发基础视频-操作系统通用快捷键操作(2)编辑快捷键.avi 06前端开发基础视频-sublime3安装和插件(1).avi 06前端开发基础视频-sublime3...
2019年河北省职业院校技能大赛 中职组Web前端开发竞赛规程.pdf2019年河北省职业院校技能大赛 中职组Web前端开发竞赛规程.pdf2019年河北省职业院校技能大赛 中职组Web前端开发竞赛规程.pdf2019年河北省职业院校技能...
Vue前端开发规范
阿里巴巴前端开发规范.docx
WEB前端开发-案例汇总(81例),前端资源大汇总;适合初学者进阶,几乎涵盖前端开发所有案例,可供学习及设计参考。
Web前端开发规范手册
Web前端开发试卷及答案.pdf
资源名称:Web前端开发的现状和未来内容简介:主题大纲前端的发展和现状行业内前端的位置前端的实际工作面临的问题未来的机遇建议的修炼之路行业内前端的位置前端很Cool?标签语义化、css布局、浏览器兼容、css ...
疯狂前端开发讲义 jQuery AngularJS Bootstrap前端开发实战
移动前端开发经验.zip移动前端开发经验.zip移动前端开发经验.zip移动前端开发经验.zip移动前端开发经验.zip移动前端开发经验.zip移动前端开发经验.zip移动前端开发经验.zip移动前端开发经验.zip移动前端开发经验.zip...
前端三大框架之一:Vue.js前端开发 PDF格式,有需要的朋友可以自行下载
通用web前端开发工程师求职简历Word模板 Web前端开发简历模板下载word WEB前端工程师简历模板 Web前端设计师简历模板 web前端个人简历模板下载 web前端开发简历模板word下载 Web前端开发英文简历模板 应届生Web前端...
Vuejs前端开发教学大纲.docxVuejs前端开发教学大纲.docxVuejs前端开发教学大纲.docxVuejs前端开发教学大纲.docxVuejs前端开发教学大纲.docxVuejs前端开发教学大纲.docxVuejs前端开发教学大纲.docxVuejs前端开发教学...
前端开发规范文档_pdf文件,开发规范命名相关,提高代码的阅读能力,以及规范性,团队协作能力,前端必备技能之一。
Web前端开发规范手册 提高团队协作效率 便于前端开发以及后期优化维护 方便新进的成员快速上手 输出高质量的代码