原文地址: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.
分享到:
相关推荐
"阿里web前端开发手册" 阿里web前端开发手册是一份详细的前端开发规范,涵盖了项目命名、目录命名、JS、CSS、SCSS、HTML、PNG 文件命名等多个方面的命名规范。下面是本手册中的一些重要知识点: 1. 命名规范: 在...
阿里巴巴前端开发规范.docx 阿里巴巴前端开发规范是阿里巴巴集团为了确保前端开发的质量和统一性而制定的规范。本规范涵盖了前端开发中的多个方面,包括命名规范、HTML 规范、CSS 规范等。 命名规范 命名规范是...
"阿里前端开发规范" 阿里前端开发规范是阿里巴巴集团为其前端开发者所制定的开发规范,旨在提高开发效率、代码质量和团队协作。该规范涵盖了前端开发的各个方面,包括命名规范、HTML 规范、CSS 规范等。 命名规范 ...
《疯狂前端开发讲义——jQuery+AngularJS+Bootstrap前端开发实战》是一本深入浅出的前端开发教程,它涵盖了三个核心的前端技术:jQuery、AngularJS和Bootstrap。这些技术在现代网页开发中扮演着至关重要的角色,使得...
《WEB前端开发-案例汇总(81例)》是一个丰富的前端学习资源库,包含了81个不同的实战案例,旨在帮助初学者逐步进阶,并为有经验的开发者提供设计和参考。这个压缩包中的每个文件代表一个独立的项目,涵盖了前端开发的...
标准的核心内容,来源于社会对Web前端开发职业活动质量的要求,是衡量从业者(包括正在接受教育与培训的准从业者)胜任Web前端开发工作的基本尺度和规范,能够反映当下时期内Web前端开发职业教育的人才培养质量规格。
vscode前端开发工具vscode前端开发工具vscode前端开发工具vscode前端开发工具vscode前端开发工具vscode前端开发工具vscode前端开发工具vscode前端开发工具vscode前端开发工具vscode前端开发工具vscode前端开发工具...
WEB前端开发案例WEB开发源代码合集(81例),前端资源大汇总;适合初学者进阶,几乎涵盖前端开发所有案例 360Barrage 360Game 360huanji 360movies 360pic 3D accordion accordion2 baidudwy baiduhf baidutm banner ...
总的来说,前端开发是一个不断发展与进步的领域,随着新的样式解决方案和组件库的不断涌现,以及前端框架的不断更新和演进,前端开发的技术栈和工具链也在不断完善和丰富。未来,前端社区将继续充满朝气与活力,为...
在如今快速发展的互联网行业,前端开发工程师的角色越发凸显其重要性。前端工程师不仅要具备扎实的技术基础,还需要不断的创新和团队协作能力。因此,在转正的关键时刻,一个详尽的转正述职报告成为不可或缺的环节。...
《Web前端开发技术储久良第三版答案》涵盖了前端开发领域的关键知识点,主要针对储久良教授编著的教材第三版中的习题和实验提供了详尽的解答。这本书旨在帮助学习者深入理解Web前端开发的核心概念和技术,通过解决...
前端开发前端ECharts图表可视化大屏开发案例.zip前端开发前端ECharts图表可视化大屏开发案例.zip前端开发前端ECharts图表可视化大屏开发案例.zip前端开发前端ECharts图表可视化大屏开发案例.zip前端开发前端ECharts...
JavaScript,作为全球最广泛使用的编程语言之一,是前端开发的核心技术。这个名为"JavaScript前端开发案例教程-源代码.rar"的压缩包文件提供了一系列实践案例,帮助开发者深入理解和掌握JavaScript在网页开发中的...
这份"web前端开发教材初级源代码.rar"压缩包提供了一套初级学习资源,旨在帮助初学者掌握基本的前端开发技能。下面我们将深入探讨这些模块及其在实际开发中的应用。 01. HTML基础 HTML(HyperText Markup Language...
Web 前端开发中级理论考试(试卷 ).rar Web 前端开发中级理论考试(试卷 ).rar Web 前端开发中级理论考试(试卷 ).rar Web 前端开发中级理论考试(试卷 ).rar Web 前端开发中级理论考试(试卷 ).rar Web 前端开发...
前端开发-Web前端开发规范手册.docx
【标题】"Web前端开发中级样题一理+实.zip" 涵盖了Web前端开发的理论与实践,这是一份针对1+x Web前端开发技能等级考试的中期练习题目集合。1+x标准旨在衡量和提升学员在Web前端领域的专业技能,确保他们具备企业级...