vue的最佳实践篇上

102 阅读3分钟

组件的命名为多个单词

#组件名应该始终是多个单词的,根组件 App 以及 、 之类的 Vue 内置组件除外。 这样避免和html元素冲突。

bad eg:

Vue.component('todo',{
	//...
})

export default {
	name:'ToDo'
	//..
}


good eg:

Vue.component('todo-item',{
	//..
})

export default {
	name:'TodoItem',
	//..
}

我认为驼峰方式 效果最好,因为大多数IDE自动完成功能都支持它。

bad

mycomponent.vue
myComponent.vue
Mycomponent.vue

good

MyComponent.vue

=========================================

###prop定义尽量详细,

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

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

#bad

props:['status'],

#good:

props:{
	status:String
}


#better:

// 更好的做法!
props: {
  status: {
    type: String,
    required: true,
    validator: function (value) {
      return [
        'syncing',
        'synced',
        'version-conflict',
        'error'
      ].indexOf(value) !== -1
    }
  }
}

###注意 props 会在组件实例创建之前进行校验,所以在 default 或 validator 函数里,诸如 data、computed 或 methods 等实例属性还无法使用。

===================================================

#为 v-for 设置key

以便维护内部组件及其子树的状态。甚至在元素上维护可预测的行为。

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>
data: function () {
  return {
    todos: [
      {
        id: 1,
        text: '学习使用 v-for'
      },
      {
        id: 2,
        text: '学习使用 key'
      }
    ]
  }
}

=============================================== Vb004-v-for与v-if不要用在一个标签上

为了过滤一个列表中的项目 (比如 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>

因此哪怕我们只渲染出一小部分用户的元素,也得在每次重渲染的时候遍历整个列表,不论活跃用户是否发生了变化。

而我们处理后

computed: {
  activeUsers: function () {
    return this.users.filter(function (user) {
      return user.isActive
    })
  }
}
<ul>
  <li
    v-for="user in activeUsers"
    :key="user.id"
  >
    {{ user.name }}
  </li>
</ul>

我们将会获得如下好处:

过滤后的列表只会在 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。

========================================

#1.单文件组件的命名

以大写开头的驼峰命名,或者全部小写中间已中划线分割。

bad

myComponent.vue

mycomponent.vue

good:

my-component.vue

MyComponent.vue

未完待续。。。 好啦看到这里,可以加群啦,公众号不定期更新技术常用干货,一同成长啦。嘻嘻!

另有github每日更新,github.com/qdleader