vant-风格指南

介绍

在参与 Vant 开发时，请遵守约定的单文件组件风格指南，指南内容节选自

Vue 官方风格指南

。

组件数据

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

单文件组件文件名称

单文件组件的文件名应该要么始终是单词大写开头 (PascalCase)，要么始终是横线连接 (kebab-case)。

紧密耦合的组件名

和父组件紧密耦合的子组件应该以父组件名作为前缀命名。

自闭合组件

在单文件组件中没有内容的组件应该是自闭合的。

Prop 名大小写

在声明 prop 的时候，其命名应该始终使用 camelCase，而在模板中应该始终使用 kebab-case。

指令缩写

指令缩写，用 `:` 表示 `v-bind:` ，用 `@` 表示 `v-on:`

Props 顺序

标签的 Props 应该有统一的顺序，依次为指令、属性和事件。

组件选项的顺序

组件选项应该有统一的顺序。

组件选项中的空行

组件选项较多时，建议在属性之间添加空行。

单文件组件顶级标签的顺序

单文件组件应该总是让顶级标签的顺序保持一致，且标签之间留有空行。