![阿里前端开发规范_第1页](http://file4.renrendoc.com/view/7ed602319dcc216bef45560ef7bd6ad2/7ed602319dcc216bef45560ef7bd6ad21.gif)
![阿里前端开发规范_第2页](http://file4.renrendoc.com/view/7ed602319dcc216bef45560ef7bd6ad2/7ed602319dcc216bef45560ef7bd6ad22.gif)
![阿里前端开发规范_第3页](http://file4.renrendoc.com/view/7ed602319dcc216bef45560ef7bd6ad2/7ed602319dcc216bef45560ef7bd6ad23.gif)
![阿里前端开发规范_第4页](http://file4.renrendoc.com/view/7ed602319dcc216bef45560ef7bd6ad2/7ed602319dcc216bef45560ef7bd6ad24.gif)
![阿里前端开发规范_第5页](http://file4.renrendoc.com/view/7ed602319dcc216bef45560ef7bd6ad2/7ed602319dcc216bef45560ef7bd6ad25.gif)
版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
阿里前端开发规范前端代码规范 3 (一)命名规范 31.1.1项目命名 31.1.2目录命名 31.1.3JS、CSS、SCSS、HTML、PNG文件命名 41.1.4命名严谨性 4(二)HTML规范(VueTemplate同样适用) 41.2.1HTML类型 41.2.2缩进 51.2.3分块注释 51.2.4语义化标签 51.2.5引号 5(三)CSS规范 61.3.1命名 61.3.2选择器 61.3.3尽量使用缩写属性 71.3.4每个选择器及属性独占一行 71.3.5省略0后面的单位 81.3.6避免使用ID选择器及全局标签选择器防止污染全局样式 8(四)LESS规范 91.4.1代码组织 91.4.2避免嵌套层级过多 9(五)Javascript规范 101.5.1命名 101.5.2代码格式 121.5.3字符串 121.5.4对象声明 131.5.5使用ES6+ 131.5.6括号 131.5.7undefined判断 141.5.8条件判断和循环最多三层 141.5.9this的转换命名 141.5.10慎用console.log 14Vue项目规范 14(一)Vue编码基础 142.1.1.组件规范 152.1.2.模板中使用简单的表达式 192.1.3指令都使用缩写形式 192.1.4标签顺序保持一致 202.1.5必须为v-for设置键值key 202.1.6v-show与v-if选择 202.1.7script标签内部结构顺序 202.1.8VueRouter规范 20(二)Vue项目目录规范 232.2.1基础 232.2.2使用Vue-cli脚手架 232.2.3目录说明 232.2.4注释说明 272.2.5其他 27前端代码规范规范的目的是为了编写高质量的代码,让你的团队成员每天得心情都是愉悦的,大家在一起是快乐的。引自《阿里规约》的开头片段:现代软件架构的复杂性需要协同开发完成,如何高效地协同呢?无规矩不成方圆,无规范难众的人身安全,试想如果标准绝不是消灭代码内容是尽可能少踩坑,杜绝踩重复的坑,切实提升系统稳定性,码出质量。一.编程规约(一)命名规范全部采用小写方式,以中线分隔。正例:mall-management-system反例:mall_management-system/mallManagementSystem全部采用小写方式,以中划线分隔,有复数结构时,要采用复数命名法,缩写不用复数。正例:scripts/styles/components/images/utils/layouts/demo-styles/demo-scripts/img/doc反例:script/style/demo_scripts/demoStyles/imgs/docs【特殊】VUE的项目中的components中的组件目录,使用kebab-case命名。正例:head-search/loading/authorized/notice-icon【特殊】VUE的项目中的除components组件目录外的所有目录也使用kebab-case命名。正例:one/shopping-car/user-managementoppingCarUserManagement全部采用小写方式,以中划线分隔。正例:render-dom.js/signup.css/index.html/company-logo.png反例:renderDom.js/UserManagement.html代码中的命名严禁使用拼音与英文混合的方式,更不允许直接使用中文的方式。说明:正确的英文拼写和语法可以让阅读者易于理解,避免歧义。注意,即使纯拼音命名方式也要避免采用正例:henan/luoyang/rmb等国际通用的名称,可视同英文反例:DaZhePromotion[打折]/getPingfenByName()[评分]/int某变量=3杜绝完全不规范的缩写,避免望文不知义:反例:AbstractClass“缩写”命名成AbsClass;condition“缩写”命名成condi,此类随意缩写严重降低了代码的可阅读性。(二)HTML规范(VueTemplate同样适用)1.2.1HTML类型推荐使用HTML5的文档类型申明:application/xhtml+xml在浏览器中的应用支持与优化空间都十分有限)。规定字符编码IE兼容模式规定字符编码doctype大写正例:<<!DOCTYPEhtml><html><head><metahttp-equiv="X-UA-Compatible"content="IE=Edge"/><metacharset="UTF-8"/><title>Pagetitle</title></head><body><imgsrc="images/company-logo.png"alt="Company"></body></html>1.2.2缩进缩进使用2个空格(一个tab);嵌套的节点应该缩进。在每一个块状元素,列表元素和表格元素后,加上一对HTML注释。1.2.4语义化标签HTML5中新增很多语义化标签,所以优先使用语义化标签,避免一个页面都是div或者p标签。正例<<header></header><footer></footer>反例<<div><p></p></div>使用双引号("")而不是单引号(’')。正例:<divclass=”box”></div>反例:<divclass=’box’></div>(三)CSS规范1.3.1命名类名使用小写字母,以中划线分隔id采用驼峰式命名scss中的变量、函数、混合、placeholder采用驼峰式命名ID和class的名称总是使用可以反应元素目的和用途的名称,或其他通用的名称,代替表象和晦涩难懂的名称。不推荐:..fw-800{font-weight:800;}.red{color:red;}推荐:..heavy{font-weight:800;}.important{color:red;}1.3.2选择器1)css选择器中避免使用标签名从结构、表现、行为分离的原则来看,应该尽量避免css中出现HTML标签,并且在css选择器中出现标签名会存在潜在的问题。2)使用直接子选择器很多前端开发人员写选择器链的时候不使用直接子选择器(注:直接子选择器和后代选择器的区别)。有时,这可能会导致疼痛的设计问题并且有时候可能会很耗性能。然而,在任何情况下,这是一个非常不好的做法。如果你不写很通用的,需要匹配到DOM末端的选择器,你应该总是考虑直接子选择器。不推荐:..content.title{font-size:2rem;}推荐:..content>.title{font-size:2rem;}1.3.3尽量使用缩写属性不推荐:borderborder-top-style:none;font-family:palatino,georgia,serif;font-size:100%;line-height:1.6;padding-bottom:2em;padding-left:1em;padding-right:1em;padding-top:0;推荐:borderborder-top:0;font:100%/1.6palatino,georgia,serif;padding:01em2em;1.3.4每个选择器及属性独占一行不推荐:buttonbutton{width:100px;height:50px;colorcolor:#fff;background:#00a0e9;}推荐:buttonbutton{width:100px;height:50px;color:#fff;background:#00a0e9;}不不推荐:div{padding-bottom:0px;margin:0em;}推荐:divdiv{padding-bottom:0;margin:0;}ID及全局标签选择器防止污染全局样式不推荐:##header{padding-bottom:0px;margin:0em;}推荐:..header{padding-bottom:0px;margin:0em;}(四)LESS规范1.4.1代码组织例://color.less,common.less2)按以下顺序组织t2、变量声明;3、样式声明;@@import"mixins/size.less";@default-text-color:#333;.page{width:960px;margin:0auto;}1.4.2避免嵌套层级过多将嵌套深度限制在3级。对于超过4级的嵌套,给予重新评估。这可以避免出现过于详实的CSS选择器。避免大量的嵌套规则。当可读性受到影响时,将之打断。推荐避免出现多于20行的嵌套规则出现。不推荐:..main{.title{.name{color:#fff;}}}推荐:..main-title{.name{color:#fff;}}(五)Javascript规范1.5.1命名不能以下划线或美元符号结束反例:_name/name_/name$,必须遵从驼峰形式正例:localValue/getHttpMessage()/inputUserId*其中method方法命名必须是动词或者动词+名词形式*正例:saveShopCarData/openShopCarInfoDialog反例:save/open/show/go*特此说明,增删查改,详情统一使用如下5个单词,不得使用其他(目的是为了统一各个端)addadd/update/delete/detail/get常用的动词:get获取/set设置,add增加/remove删除,create创建/destory销毁,start启动/stop停止,open打开/close关闭,read读取/write写入,load载入/save保存,begin开始/end结束,backup备份/restore恢复,import导入/export导出,split分割/merge合并,injectinject注入/extract提取,attach附着/detach脱离,bind绑定/separate分离,view查看/browse浏览,edit编辑/modify修改,select选取/mark标记,copy复制/paste粘贴,undo撤销/redo重做,insert插入/delete移除,add加入/append添加,clean清理/clear清除,index索引/sort排序,find查找/search搜索,increase增加/decrease减少,play播放/pause暂停,launch启动/run运行,compile编译/execute执行,debug调试/trace跟踪,observe观察/listen监听,build构建/publish发布,input输入/output输出,encode编码/decode解码,encrypt加密/decrypt解密,compress压缩/decompress解压缩,pack打包/unpack解包,parse解析/emit生成,connect连接/disconnect断开,send发送/receive接收,download下载/upload上传,refresh刷新/synchronize同步,update更新/revert复原,lock锁定/unlock解锁,checkout签出/checkin签入,submit提交/commit交付,push推/pull拉,expand展开/collapse折叠,enter进入/exit退出,abort放弃/quit离开,obsolete废弃/depreciate废旧,collect收集/aggregate聚集达完整清楚,反例:MAX_COUNT1.5.2代码格式1)使用2个空格进行缩进正例:ifif(x<y){x+=10;}else{x+=1;}说明:任何情形,没有必要插入多个空行进行隔开。统一使用单引号(‘),不使用双引号(“)。这在创建HTML字符串非常有好处:正例:letletstr='foo';lettestDiv='<divid="test"></div>';反例:letletstr='foo';lettestDiv="<divid='test'></div>";1.5.4对象声明1)使用字面值创建对象反例:letuser=newObject();2)使用字面量来代替对象构造器正例:varvaruser={age:0,name:1,city:3反例:varvaruser=newObject();user.age=0;=0;user.city=0;1.5.5使用ES6+必须优先使用ES6+中新增的语法糖和函数。这将简化你的程序,并让你的代码更加灵活和可复1.5.6括号下列关键字后必须有大括号(即使代码块的内容只有一行):if,else,for,while,do,switch,try,catch,finally,with。正例:ifif(condition){doSomething();}反例:ifif(condition)doSomething();1.5.7undefined判断永远不要直接使用undefined进行变量判断;使用typeof和字符串’undefined’对变量进行判断。正例:ifif(typeofperson==='undefined'){...}反例:ifif(person===undefined){...}1.5.8条件判断和循环最多三层条件判断能使用三目运算符和逻辑运算符解决的,就不要使用条件判断,但是谨记不要写太长的三目运算符。如果超过3层请抽成函数,并写清楚注释。1.5.9this的转换命名对上下文this的引用只能使用’self’来命名。1.5.10慎用console.log因console.log大量使用会有性能问题,所以在非webpack项目中谨慎使用log功能。二、Vue项目规范(一)Vue编码基础vue项目规范以Vue官方规范(/v2/style-guide/)中的A规范为基础,在其上面进行项目开发,故所有代码均遵守该规范。请仔仔细细阅读Vue官方规范,切记,此为第一步。2.1.1.组件规范1)组件名为多个单词组件名应该始终是多个单词组成(大于等于2),且命名规范为kebab-case格式。这样做可以避免跟现有的以及未来的HTML元素相冲突,因为所有的HTML元素名称都是单个单词的。正例:exportexportdefault{name:'TodoItem'//...反例:exportexportdefault{name:'Todo',//...}exportdefault{name:'todo-item',//...}2)组件文件名为pascal-case格式正例:components/my-component.vue反例:components/myComponent.vueMyComponent.vue3)基础组件文件名为base开头,正例:使用完整单词而不是缩写components/base-button.vue|-|-base-table.vue|-base-icon.vue反例:componentscomponents/|-MyButton.vueVueTablevueconvue4)和父组件紧密耦合的子组件应该以父组件名作为前缀命名正例:componentscomponents/|-todo-list.vue|-todo-list-item.vue|-todo-list-item-button.vue|-user-profile-options.vue(完整单词)反例:componentscomponents/Listvue-TodoItem.vue|-TodoButton.vue|-UProfOpts.vue(使用了缩写)5)在Template模版中使用组件,应使用PascalCase模式,并且使用正例:<!--在单文件组件、字符串模板和JSX中--><<MyComponent/><Row><table:column="data"/></Row>反例:<<my-component/><row><table:column="data"/></row>6)组件的data必须是一个函数当在组件中使用data属性的时候(除了newVue外的任何地方),它的值必须是返回一个对象的函数。因为如果直接是一个对象的话,子组件之间的属性值会互相影响。正例:exportexportdefault{data(){return{name:'jack'}}}反例:exportexportdefault{data:{name:'jack'}}7)Prop定义应该尽量详细必须使用camelCase驼峰命名必须指定类型必须加上注释,表明其含义必须加上required或者default,两者二选其一如果有业务需要,必须加上validator验证正例:propsprops:{//组件状态,用于控制组件的颜色status:{type:String,dtruevalidator:function(value){return['succ','info','error'].indexOf(value)!==-1}//用户级别,用于显示皇冠个数rLeveltype:String,}}8)为组件样式设置作用域正例:<<template><buttonclass="btnbtn-close">X</button></template><!--使用`scoped`特性--><stylescoped>.btn-close{background-color:red;}</style>反例:<<template><buttonclass="btnbtn-close">X</button></template><!--没有使用`scoped`特性--><style>.btn-close{background-color:red;}</style>9)如果特性元素较多,应该主动换行正例:<<MyComponentfoo="a"bar="b"baz="c"foo="a"bar="b"baz="c"foo="a"bar="b"baz="c"/>反例:<MyComponentfoo="a"bar="b"baz="c"foo="a"bar="b"baz="c"foo="a"bar="b"baz="c"foo="a"bar="b"baz="c"/>2.1.2.模板中使用简单的表达式组件模板应该只包含简单的表达式,复杂的表达式则应该重构为计算属性或方法。复杂表达式会让你的模板变得不那么声明式。我们应该尽量描述应该出现的是什么,而非如何计算那个值。而且计算属性和方法使得代码可以重用。正例:<<template><p>{{normalizedFullName}}</p></template>//复杂表达式已经移入一个计算属性omputednormalizedFullName:function(){returnthis.fullName.split('').map(function(word){returnword[0].toUpperCase()+word.slice(1)}).join('')}}反例:<<template><p>fullName.split('').map(function(word){returnword[0].toUpperCase()+word.slice(1)}).join('')</p></template>2.1.3指令都使用缩写形式指令推荐都使用缩写形式,(用:表示v-bind:、用@表示v-on:和用#表示v-slot:)正例:<<input@input="onInput"@focus="onFocus">反例:<<inputvv-on:input="onInput"@focus="onFocus">2.1.4标签顺序保持一致单文件组件应该总是让标签顺序保持为`正例:<<template>...</template><script>...</script><style>...</style>反例:<<template>...</template><style>...</style><script>...</script>2.1.5必须为v-for设置键值key2.1.6v-show与v-if选择如果运行时,需要非常频繁地切换,使用v-show;如果在运行时,条件很少改变,使用v-if。2.1.7script标签内部结构顺序name>components>mixins>props>data>computed>watch>filter>钩子函数(钩子函数按其执行顺序)>methods2.1.8VueRouter规范1)页面跳转数据传递使用路由参数页面跳转,例如A页面跳转到B页面,需要将A页面的数据传递到B页面,推荐使用路由参数进行传参,而不是将需要传递的数据保存vuex,然后在B页面取出vuex的数据,因为如果在B页面刷新会导致vuex数据丢失,导致B页面无法正常显示数据。正例:letletid='123';this.$router.push({name:'userCenter',query:{id:id}});2)使用路由懒加载(延迟加载)机制{{path:'/uploadAttachment',name:'uploadAttachment',meta:{title:'上传附件'component:()=>import('@/view/components/uploadAttachment/index.vue')3)router中的命名规范path、childrenPoints命名规范采用kebab-case命名规范(尽量vue文件的目录结构保持一致,因为目录、文件名都是kebab-case,这样很方便找到对应的文件)name命名规范采用kebab-case命名规范且和component组件名保持一致!(因为要保持keep-alive特性,keep-alive按照component的name进行缓存,所以两者必须高度保持一致)///动态加载exportconstreload=[{path:'/reload',name:'reload',component:Main,meta:{title:'动态加载',icon:'iconiconfont'children:[{path:'/reload/smart-reload-list',tReloadListmeta:{title:'SmartReload',childrenPoints:[{title:'查询',name:'smart-reload-search'{titletitle:'执行reload',name:'smart-reload-update'{title:'查看执行结果',name:'smart-reload-result'component:()=>import('@/views/reload/smart-reload/smart-reload-list.vue')4)router中的path命名规范path除了采用kebab-case命名规范以外,必须以/开头,即使是children里的path也要以/开hparent和children组成的,可能经常需要在router文件里搜索多次才能找到,而如果以/开头,则能立刻搜索到对应的组件。{{path:'/file',name:'File',component:Main,meta:{title:'文件服务',icon:'ios-cloud-upload'children:[{path:'/file/file-list',name:'FileList',component:()=>import('@/views/file/file-list.vue'){path:'/file/file-add',name:'FileAdd',component:()=>import('@/views/file/file-add.vue'){path:'/file/file-update',|--|--role-list.vuenamename:'FileUpdate',component:()=>import('@/views/file/file-update.vue')}(二)Vue项目目录规范2.2.1基础vue项目中的所有命名一定要与后端命名统一。比如权限:后端privilege,前端无论router,store,api等都必须使用privielege单词!2.2.2使用Vue-cli脚手架使用vue-cli3来初始化项目,项目名按照上面的命名规范。目录名按照上面的命名规范,其中components组件用大写驼峰,其余除components组件目录外的所有目录均使用kebab-case命名。srcsrcssets|--componentsonfig|--constants|--directivesrsock|--pluginster|--themess||源码目录所有api接口静态资源,images,icons,styles等公用组件配置信息常量信息,项目所有Enum,全局常量等自定义指令过滤器,全局工具模拟数据,临时存放外部引用的插件存放及修改文件模拟接口,临时存放插件,全局使用路由,统一管理vuex,统一管理自定义样式主题视图目录role模块名role列表页面|||||||--|--role-add.vue|--|--role-update.vue|--|--index.less|--|--components|--employeerole新建页面role更新页面role模块样式role模块通用组件文件夹employee模块文件、变量命名要与后端保持一致。此目录对应后端API接口,按照后端一个controller一个api.js文件。若项目较大时,可以按照业务划分子目录,并与后端保持一致。api中的方法名字要与后端apiurl尽量保持语义高度一致性。对于api中的每个方法要添加注释,注释与后端swagger文档保持一致。正例:/employee/add/employee/delete/{id}/employee/update//添加员工functionaddEmployee(data){returnpostAxios('/employee/add',data)}//更新员工信息functionupdateEmployee(data){returnpostAxios('/employee/update',data)}//删除员工functiondeleteEmployee(employeeId){returnpostAxios('/employee/delete/'+employeeId)}//获取员工信息functiongetEmployee(data){returnpostAxios('/employee/get/',data)}//获取员工信息列表functiongetEmployeeList(data){returnpostAxios('/employee/getlist/',data)}assets为静态资源,里面存放images,styles,
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 部编版道德与法治六年级下册第1课《学会尊重》教学设计【核心素养教案】
- 手术演示丨人工全膝关节翻修术(含视频)
- 工会夏送清凉活动方案
- 哈密市2024年小学六年级第二学期小升初数学试卷含解析
- 病毒性肝炎健康管理专家共识2021版
- 加入民盟申请书
- 高速铁路隧道工程施工审核检查要点
- 初中一年级上学期生物《动物细胞》教学设计
- 某精密薄板有限公司年产25万吨冷轧薄板工程项目技术方案设计
- 江苏省昆山市高科技工业园区区域环境影响评价与环境保护规划
- 【公开课】免疫失调课件高二上学期生物人教版选择性必修1
- 明德云学堂义务教育心得
- 混凝土工程外观质量缺陷检查处理方案
- 机加工作业指导书(中英)
- 老人信息的登记表
- 钻井泥浆排量计算
- 季度药品养护汇总分析表及模版
- 教育家精神微课PPT
- 模块4 工作装置与标准化施工作业《铁路大型捣固设备与运用》教学课件
- 浙教版七年级科学上册 (科学测量)教学课件
- 机器人与智能制造技术
评论
0/150
提交评论