標簽
小程序視圖層開發基於小程序框架為開發者提供的一系列基礎組件,這些基礎組件通常以雙標簽或單標簽的形式使用。
- 雙標簽包括起始標簽<標簽>,結止標簽</標簽>和屬性,內容在這兩個標簽之內
- 單標簽只有一個<標簽/>,有屬性,沒有內容
小程序規定,標簽名有多個詞時,詞之間以連接符-連接。
<tag-name property="value">
內容放這里...
</tag-name>
<tag-name property="value"/>
編碼時要遵循標簽的語義,要盡量使用最少的標簽並保持最小的復雜度。
代碼大小寫
所有標簽和屬性,大部分屬性值統一使用小寫
-
推薦寫法
...
-
不推薦寫法
...
<VIEW CLASS="DEMO"> ... </VIEW>
標簽的閉合
在小程序里,有些組件必須寫成雙標簽,如視圖容器類組件view;有些組件可以寫成單標簽,如媒體類組件image;但在小程序運行時,它們都會解析成雙標簽。
在小程序里,所有的標簽一旦使用都必須被閉合,使用標簽不閉合會報錯,導致程序無法運行。
- 正確寫法
我是一段文字,我有始有
- 錯誤寫法
我是一段文字,我有始有
團隊約定
所有具有開始標簽和結束標簽的元素都要寫上起止標簽,某些可以省略結束標簽的亦都要寫上
- 推薦寫法
我是一段文字,我有始有
- 不推薦寫法
標簽屬性
團隊約定
- 標簽屬性值使用雙引號語法
- 屬性值可能寫上的都寫上
- 推薦寫法
- 不推薦寫法
- 錯誤寫法
- 推薦寫法
- 謹慎使用id屬性
id屬性具有唯一性,可以用來標識具體組件,應避免在樣式上使用id屬性(選擇器) - 屬性書寫順序
標簽屬性應按照以下順序依次排列,以確保代碼的可讀性
/*
id,
class,
wx:for wx:item wx:key,
wx:if,
src,
事件綁定類屬性,如bind:tap,
value,
dataSet,(*需完善)
組件自帶的其它屬性,
*/
特殊字符
正常情況下的小程序里,文本和字符實體不能混合出現。
- 如需使用字符實體,需使用text組件並設置decode屬性,並且decode目前僅可解析 < > & ' ,參考text文檔
- 正確用法
< > - 錯誤用法
< >
< >
- 正確用法
- 特殊符號使用輸入法輸入即可
- 連續空格的使用
- 需使用text組件並設置space屬性
- 無space屬性的text內多個連續空格最終只顯示一個
- 非text組件設置space屬性不會有連續空格的效果
- 正確寫法
1 1 1 1
// 輸出:1 1 1 1 - 無效寫法
1 1 1 1
// 輸出:1 1 1 1
- 正確寫法
代碼縮進
統一使用2個空格字符進行代碼縮進
- 推薦寫法
2個空格字符縮進
...
- 不推薦寫法
4個空格字符縮進
...
在微信開發者工具-設置-編輯設置,勾選用空格代碼Tab,Tab大小設置為2,使用格式化代碼可以自動縮進對齊。
代碼嵌套
編寫wxml代碼時,需要保證頁面結構穩固,同時需要避免多余的父元素,減少嵌套。
- 推薦寫法
小明
- 不推薦寫法
小明
塊級標簽的起止標簽各占一行,行內標簽的起止標簽一般寫在一行內,如果標簽內容過多,起止標簽則各占一行。
- 推薦寫法
小明
原有獎勵模式已改為積分獎勵,針對部分未兌換禮品的用戶,已為您補發積分獎勵,如有疑問請聯系微信客服:yiniankefu
- 不推薦寫法
小明