规范与每个团队和个人都是息息相关的,因为其影响的不只是只是代码的维护和理解成本,严重的时候是会影响成员开发的心情
创新互联网站建设公司,提供网站设计制作、成都网站制作,网页设计,建网站,PHP网站建设等专业做网站服务;可快速的进行网站开发网页制作和功能扩展;专业做搜索引擎喜爱的网站,是专业的做网站团队,希望更多企业前来合作!
一个团队的编码规范、git规范等,并没有绝对的最优解,心里要清楚明白没有银弹,规范是为了让团队统一,提高代码阅读性、降低代码维护成本等,本文是记录一些在项目code review中常见的规范,仅供参考
JS部分
和渲染无关的数据
vue中data的数据默认便会进行双向数据绑定,若是将大量的和渲染无关的数据直接放置在data中,将会浪费双向数据绑定时所消耗的性能,将这些和渲染无关的数据进行抽离并配合Object.freeze进行处理
table中columns数据可以单独提取一个外部js文件作为配置文件,也可以在当前.vue文件中定义一个常量定义columns数据,因为无论如何都是固定且不会修改的数据,应该使用Object.freeze进行包裹,既可以提高性能还可以将固定的数据抽离,一些下拉框前端固定的数据也建议此操作
- const columnList = Object.freeze([
- { title: '姓名', key: 'name', align: 'center' },
- { title: '性别', key: 'gender', align: 'center' }
- ])
需要注意的是 Object.freeze() 冻结的是值,这时仍然可以将变量的引用替换掉,还有确保数据不会变才可以使用这个语法,如果要对数据进行修改和交互,就不适合使用冻结了。
Modal框的控制
一个页面种通常会存在很多个不同功能的弹框,若是每一个弹框都设置一个对应的变量来控制其显示,则会导致变量数量比较冗余和命名困难,可以使用一个变量来控制同一页面中的所有Modal弹框的展示
比如某个页面中存在三个Modal弹框
- // bad
- // 每一个数据控制对应的Modal展示与隐藏
- new Vue({
- data() {
- return {
- modal1: false,
- modal2: false,
- modal3: false,
- }
- }
- })
- // good
- // 当modalType为对应的值时 展示其对应的弹框
- new Vue({
- data() {
- return {
- modalType: '' // modalType值为 modal1,modal2,modal3
- }
- }
- })
debounce使用
例如远程搜索时需要通过接口动态的获取数据,若是每次用户输入都接口请求,是浪费带宽和性能的
当一个按钮多次点击时会导致多次触发事件,可以结合场景是否立即执行immediate
- import {debounce} from 'lodash'
- methods:{
- remoteMethod:debounce(function (query) {
- // to do ...
- // this 的指向没有问题
- }, 200),
- }
图片
功能的开发过程中,图片的处理往往是比较容易被忽略的环节,也会在一定程度影响开发的效率和页面的性能
路由组件传参
在组件中使用 $route 会使之与其对应路由形成高度耦合,从而使组件只能在某些特定的 URL 上使用,限制了其灵活性。
使用 props 将组件和路由解耦:
取代与 $route 的耦合
- const User = {
- template: '
User {{ $route.params.id }}'- }
- const router = new VueRouter({
- routes: [
- { path: '/user/:id', component: User }
- ]
- })
通过 props 解耦
这样你便可以在任何地方使用该组件,使得该组件更易于重用和测试。
- const User = {
- props: ['id'],
- template: '
User {{ id }}'- }
- const router = new VueRouter({
- routes: [
- { path: '/user/:id', component: User, props: true },
- // 对于包含命名视图的路由,你必须分别为每个命名视图添加 `props` 选项:
- {
- path: '/user/:id',
- components: { default: User, sidebar: Sidebar },
- props: { default: true, sidebar: false }
- }
- ]
- })
参考:路由组件传参
Vue生命周期
在父子组件中,掌握父子组件对应的生命周期钩子加载顺序可以让开发者在更合适的时候做适合的事情父组件
home
子组件
- list
加载时父子组件的加载顺序
- home beforeCreate --> home created --> home beforeMount --> list created --> list beforeMount --> list mounted
销毁时父子组件的销毁顺序
- home beforeDestroy --> list beforeDestroy --> list destroyed --> home destroyed
实际开发过程中会遇到当子组件某个生命周期完成之后通知父组件,然后在父组件做对应的处理
emit up
- // 子组件在对应的钩子中发布事件
- created(){
- this.$emit('done')
- }
- // 父组件订阅其方发
hook
通过@hook监听子组件的生命周期
Select优化
下拉框遍历时,需要注意options标签保持同一行,若是存在换行,会导致选中时的值存在多余的空白
- {{item.label}}
需要将Options和下拉框的值保持在同一行
data数据层级
data数据具有数据层级结构,切勿过度扁平化或者嵌套层级过深,若是过度扁平化会导致数据命名空间冲突,参数传递和处理,若是层级嵌套过深也会导致vue数据劫持的时候递归层级过深,若是嵌套层级丧心病狂那种的,小心递归爆栈的问题。而且层级过深会导致数据操作和处理不便,获取数据做容错处理也比较繁琐。一般层级保持2-3层最好。
若是只有一层数据,过于扁平
- {
- name: '',
- age: '',
- gender: ''
- }
导致处理不方便
- // 作为接口参数传递
- ajax({
- this.name, this.age, this.gender
- })
- // 接口获取数据,批量处理
- ajax().then(res => {
- const {name, age, gender} = res.data
- this.name = name
- this.age = age
- this.gender = gender
- })
适当的层级结构不仅增加代码的维护和阅读性,还可以增加操作和处理的便捷性
- {
- person: { // 个人信息
- name: '',
- age: '',
- gender: ''
- }
- }
可以针对person进行操作
- // 作为接口参数传递
- ajax(this.person)
- // 接口获取数据,批量处理
- ajax().then(res => {
- const {name, age, gender} = res.data
- this.$set(this, 'person', {name, age, gender})
- })
策略模式
策略模式的使用,避免过多的if else判断,也可以替代简单逻辑的switch
- const formatDemandItemType = (value) => {
- switch (value) {
- case 1:
- return '基础'
- case 2:
- return '高级'
- case 3:
- return 'VIP'
- }
- }
- // 策略模式
- const formatDemandItemType2 = (value) => {
- const obj = {
- 1: '基础',
- 2: '高级',
- 3: 'VIP',
- }
- return obj[value]
- }
解构
解构赋值以及默认值,当解构的数量小于多少时适合直接解构并赋值默认值,数据是否进行相关的聚合处理
- const {
- naem = '',
- age = 10,
- gender = 'man'
- } = res.data
- // bad
- this.name = name
- this.age = age
- this.gender = gender
- // good
- this.person = {
- naem,
- age,
- gender
- }
职责单一
任何时候尽量是的一个函数就做一件事情,而不是将各种逻辑全部耦合在一起,提高单个函数的复用性和可读性
每个页面都会在加载完成时进行数据的请求并展示到页面
- created() {
- this.init();
- },
- methods: {
- // 将全部的请求行为聚合在init函数中
- // 将每个请求单独拆分
- init() {
- this.getList1()
- this.getList2()
- },
- getList1() {
- // to do ...
- },
- getList2() {
- // to do ...
- }
- }
v-bind
HTML部分
html书写
编写template模板时,属性过多时,是否换行
- class="icon-button go-up"
- icon-left="keyboard_arrow_up"
- v-tooltip="$t('org.vue.components.folder-explorer.toolbar.tooltips.parent-folder')"
- @click="openParentFolder"
- />
实体使用
html中展示一些如<,>,&等字符时,使用字符实体代替
- > 1 & < 12
- > 1 & < 12
CSS部分
样式穿透
在开发中修改第三方组件样式是很常见,但由于 scoped 属性的样式隔离,可能需要去除 scoped 或是另起一个 style 。这些做法都会带来副作用(组件样式污染、不够优雅),样式穿透在css预处理器中使用才生效。
空格
适当的空格可以提升代码的阅读体验,显得更为优雅和美观
选择器后、属性值
- .custom-style { // 选择器和{ 之间空格
- margin: 0; // 属性值前
- transform: scale(1.5, 2.2); // 逗号之后增加空格
- }
换行
和html类型,当某行的属性很多,适当的换行可以提高阅读和美观
- .custom-style{
- // 可以在一次声明中定义一个或多个属性
- background: background-clip
- background-color
- background-image
- background-origin
- background-position
- background-repeat
- background-size;
- }
当一个规则包含多个选择器时,每个选择器声明必须独占一行,过长导致需要横向滚动阅读剩余的内容,应该尽量使得阅读顺序纵向化
- .custom .header .title,
- .other .header .title {
- color: #f0f;
- }
嵌套层级
浏览器在解析css时,是按照从右到左递归匹配的,过深的层级嵌套不仅影响性能,而且还会导致样式阅读性和代码维护性降低,一般层架控制在5层之内
双引号
属性选择器中的值必须用双引号包围,不允许使用单引号,也不允许不使用引号,html的属性值也是推荐使用双引号,js中使用单引号
- .custom-style{
- font-family: "PingFang SC", "STHeitiSC-Light";
- }
属性顺序
同一 规则下的属性在书写时,应按功能进行分组。并以 Formatting Model(布局方式、位置) > Box Model(尺寸) > Typographic(文本相关) > Visual(视觉效果) 的顺序书写,以提高代码的可读性。
解释:
另外,为增加可读性,如果包含 content 属性,应放在属性的最前面。
文章标题:一个优秀的Vue团队代码规范是什么样子的?
URL链接:http://www.stwzsj.com/qtweb/news30/9430.html
网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等
声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联