[聚合文章] vue风格指南小结

vue.js 2018-02-01 14 阅读


摄于2018年01月26日 20:04:56 杭州西湖音乐喷泉

有一个良好的编码习惯风格对程序员来说也是功底的考究,而且还能规避一些不必要的错误,提高代码可读性,况且这也是一个优雅编写Vue的开始,嗯,完美Perfect。个人博客
组件数据

组件的 data 必须是一个函数。

当在组件中使用 data 属性的时候(除了 new Vue 外的任何地方),它的值必须是返回一个对象的函数。 Vue希望每个组件实例都相对应地管理自己的数据,而不是在复用组件时各个组件之间出现数据混乱的情况,所以要求每个实例必须生成一个独立的数据对象。

Bad =>

Vue.component('todo-list', {
    data: {
        foo: 'bar'
    }
})

Good =>

Vue.component('todo-list', {
    data: function() {
        return {
            foo: 'bar'
        }
    }
})
Prop 定义

Prop定义应该尽量详细,至少需要指定其类型。

细致的 prop定义 有两个好处:

  • 他们写明了组件的API,所以很容易看懂组件的用法;
  • 在开发环境下,如果向一个组件提供格式不正确的prop,Vue将会抛出警告,以帮助你捕获潜在的错误来源。

Bad =>

// 这样做只有开发原型系统时可以接受
props: ['status']

Good =>

props: {
    status: String
}

Better =>

props: {
    status: {
        type: String,
        required: true,
        // 自定义函数验证
        validator: function(value) {
            return value > 10
        }
    }
}
v-for 设置键值

总是用 key 配合 v-for ,以便维护内部组件及其子树的状态(虚拟DOM,diff算法)。
Bad =>

<ul>
    <li v-for= "todo in todos">
        {{todo.text}}
    </li>
</ul>

Good =>

<ul>
    <li v-for= "todo in todos" :key="todo.id">
        {{todo.text}}
    </li>
</ul>
避免 v-ifv-for 用在一起

永远不要把 v-ifv-for 同时用在同一个元素上。
一般以下两种情况我们会倾向于这么做:

  • 为了过滤一个列表中的项目(比如 v-for="user in users" v-if="user.isActive" )。在这种情形下,请将 users 替换为一个计算属性(比如 activeUsers),让其返回过滤后的列表。
  • 为了避免渲染本应该被隐藏的列表(比如 v-for="user in users" v-if="shouldShowUsers" )。这种情形下,请将 v-if 移动至容器元素上(比如 ul,ol)。

详解
当Vue处理指令时,v-forv-if 具有更高的优先级,所以这个模板:

<ul>
    <li
        v-for="user in users"
        v-if="user.isActive"
        :key="user.id"
        >
        {{ user.name }}
    <li>
</ul>

将会经过如下运算:

this.users.map( user => {
    if(user.isActive) {
        return user.name
    }
})

因此哪怕只渲染出一小部分用户的元素,也得在每次重渲染的时候遍历整个列表,不论活跃用户是否发生了变化。
通过将其更换为在如下的一个计算属性上遍历:

<ul>
    <li
        v-for="user in activeUsers"
        :key="user.id"
    >
        {{ user.name }}
    <li>
</ul>

computed: {
    activeUsers: function () {
        return this.users.filter(function (user) {
            return user.isActive
        })
    }
}

这样写将会获得以下好处:

  • 过滤后的列表只会在 users 数组发生相关变化时才被重新运算,过滤更高效。
  • 使用 v-for="user in activeUsers" 之后,在渲染的时候只遍历活跃用户,渲染更高效。
  • 解耦渲染层的逻辑,可维护性更强。

为了获得同样的好处,也可以这样写:

<ul v-if="shouldShowUsers">
    <li
        v-for="user in users"
        :key="user.id"
    >
        {{ user.name }}
    <li>
</ul>

通过将 v-if 移动到容器元素,我们不会再对列表中的每个用户检查 shouldShowUsers。取而代之的是,我们只检查它一次,且不会在 shouldShowUsers 为否的时候运算 v-for

END

以上主要总结了一些常用的规范,具体完整的文档请移步这里

注:本文内容来自互联网,旨在为开发者提供分享、交流的平台。如有涉及文章版权等事宜,请你联系站长进行处理。