組件的命名需遵從以下原則:
* 有意義的: 不過于具體,也不過于抽象
* 簡短: 2 到 3 個單詞
* 具有可讀性: 以便于溝通交流
同時還需要注意:
* 必須符合自定義元素規范:?[使用連字符](https://www.w3.org/TR/custom-elements/#concepts)分隔單詞,切勿使用保留字。
* `app-`?前綴作為命名空間: 如果非常通用的話可使用一個單詞來命名,這樣可以方便于其它項目里復用。
### [](https://github.com/pablohpsilva/vuejs-component-style-guide/blob/master/README-CN.md#為什么)為什么?
* 組件是通過組件名來調用的。所以組件名必須簡短、富有含義并且具有可讀性。
### [](https://github.com/pablohpsilva/vuejs-component-style-guide/blob/master/README-CN.md#如何做)如何做?
```text-html-basic
<!-- 推薦 -->
<app-header></app-header>
<user-list></user-list>
<range-slider></range-slider>
<!-- 避免 -->
<btn-group></btn-group> <!-- 雖然簡短但是可讀性差. 使用 `button-group` 替代 -->
<ui-slider></ui-slider> <!-- ui 前綴太過于寬泛,在這里意義不明確 -->
<slider></slider> <!-- 與自定義元素規范不兼容 -->
```
- Vue開發規范
- 基于模塊開發
- 組件
- 組件命名規則
- 基礎組件名
- 單例組件名
- 緊密耦合的組件名
- 組件名中的單詞順序
- 組件文件夾命名規則
- method方法
- methods方法命名規則
- 組件結構化
- 組件事件命名規則
- v-for與v-if
- 為 v-for 設置鍵值
- 避免 v-if 和 v-for 用在一起
- Prop
- Prop命名規則
- Prop定義
- 避免 this.$parent
- 謹慎使用 this.$refs
- 隱性的父子組件通信
- 元素
- 元素特性的順序
- 多個特性的元素擺放規則
- 單文件組件的頂級元素的順序
- 簡化代碼
- 模板中簡單的表達式
- 簡單的計算屬性
- 指令縮寫
- 文件引用路徑
- 其他注意
- 組件數據
- 將 this 賦值給 component 變量
- 對組件文件進行代碼校驗
- 盡可能使用 mixins
- 非 Flux 的全局狀態管理
- 只在需要時創建組件
- HTML開發規范
- HTML語法
- HTML5 doctype
- 語言屬性
- IE 兼容模式
- 字符編碼
- 引入 CSS 和 JavaScript 文件
- 實用為王
- 屬性順序
- 布爾(boolean)型屬性
- 減少標簽的數量
- JavaScript 生成的標簽
- CSS開發規范
- CSS語法
- 聲明順序
- 不要使用 @import
- 媒體查詢(Media query)的位置
- 帶前綴的屬性
- 單行規則聲明
- 簡寫形式的屬性聲明
- Less 和 Sass 中的嵌套
- Less 和 Sass 中的操作符
- 注釋
- class 命名
- 選擇器
- 代碼組織