前端开发规范文档手册(阿里巴巴前端文件命名规范)
阿里巴巴前端开发规范文档手册中,包含了对前端项目中文件命名的规范要求。以下是一些主要的规范要点:
文件命名使用小写字母,多个单词之间使用中划线(-)进行连接。例如:home-page.css。
HTML文件命名应以页面功能为准,使用英文描述。例如:login.html。
CSS文件命名应与对应的HTML文件相对应,使用同样的名称。例如:login.css。
JavaScript文件命名应使用驼峰命名法,以描述该文件功能为准。例如:loginValidation.js。
图片文件命名应使用有意义的名称,描述图片内容或用途。例如:logo.png。
其他静态资源文件(如字体、视频等)命名也应使用有意义的名称。
避免使用数字作为文件名的一部分,除非其具有特殊意义。
避免使用无关的缩写和简写,尽量保持文件名的清晰和易读性。
不同类型的文件应放置在对应的文件夹下,以便于管理和导航。例如,将所有的样式文件放在一个名为"styles"的文件夹下。
对于公共组件或库文件,可以使用带有版本号的文件夹进行管理。例如:jquery-3.3.1.min.js。
这些规范旨在提高团队的代码可读性、可维护性和协作效率,建议开发人员遵循并在项目中贯彻执行。
一、HTML规范
使用小写字母标记标签和属性
缩进代码以提高可读性
避免使用无用的标记和属性
使用语义化标记(如 <header>,<nav>,<footer> 等)来提高可访问性和 SEO
使用双引号(而不是单引号)来包围属性值
二、CSS规范
选择器应该简短、有意义、易于理解
避免使用 ID 选择器(除非必要)
避免使用 !important,使用优先级来解决冲突
将样式表分解成多个文件,以提高可维护性和可重用性
使用 CSS 预处理器,如 Sass 或 LESS 来提高开发效率
三、JavaScript规范
使用驼峰式命名变量、函数和方法
使用 const 和 let 来声明变量和常量,避免使用 var
不要在循环中创建新的函数或对象,因为这会降低性能
避免使用 eval() 和 with(),因为这可能会导致安全漏洞
使用模块化,如 ES6 模块,来避免全局变量和命名冲突
四、通用规范
注释代码以提高可读性
使用缩进和空格来提高可读性
避免使用行内样式和脚本
在代码中使用空行和注释,以便将代码块分组并提高可读性
避免在代码中使用硬编码值,而是使用变量和常量来提高可维护性
| 前端官方文档资源
MDN Web Docs:https://developer.mozilla.org/zh-CN/docs/Web
MDN Web Docs是一个面向Web开发者的文档库,提供关于Web技术的详细文档和教程,包括HTML、CSS、JavaScript、Web API等方面的内容。它由Mozilla公司维护,内容丰富全面,是学习和查阅Web开发文档的良好资源。
W3C:https://www.w3.org/
W3C是Web标准化组织,提供了许多关于Web技术标准的文档和规范,如HTML、CSS、XML、SVG等。它是全球最权威的Web标准组织之一,了解W3C的规范和指南可以帮助我们编写更加符合标准的Web应用程序。
ECMAScript官方文档:https://www.ecma-international.org/ecma-262/
ECMAScript是JavaScript的标准,它规定了JavaScript的语法、类型、语句、关键字、保留字等方面的内容。了解ECMAScript的规范可以帮助我们更好地理解和使用JavaScript语言。
Vue.js官方文档:https://v3.cn.vuejs.org/
Vue.js是一款流行的JavaScript框架,提供了丰富的文档和教程,适合从入门到高级的开发者。Vue.js的官方文档介绍了框架的各种特性和用法,帮助开发者快速掌握Vue.js的知识。
| 最后整理了一些大厂的前端代码规范,可以参考
腾讯:http://tgideas.qq.com/doc/index.html
京东:https://guide.aotu.io/index.html
阿里巴巴:https://github.com/airbnb/javascript
百度:https://github.com/ecomfe/spec/blob/master/javascript-style-guide.md
网易:http://nec.netease.com/standard
原文地址:https://tangjiusheng.cn/web/qdkf/6585.html