vue风格指南小结

摄于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-if 和 v-for 用在一起

永远不要把 v-if 和 v-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-for 比 v-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

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