微信小程序開發規范文檔-WXML代碼規范


標簽

小程序視圖層開發基於小程序框架為開發者提供的一系列基礎組件,這些基礎組件通常以雙標簽或單標簽的形式使用。

  • 雙標簽包括起始標簽<標簽>,結止標簽</標簽>和屬性,內容在這兩個標簽之內
  • 單標簽只有一個<標簽/>,有屬性,沒有內容

小程序規定,標簽名有多個詞時,詞之間以連接符-連接。

<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代碼時,需要保證頁面結構穩固,同時需要避免多余的父元素,減少嵌套。

  • 推薦寫法
  • 不推薦寫法

塊級標簽的起止標簽各占一行,行內標簽的起止標簽一般寫在一行內,如果標簽內容過多,起止標簽則各占一行。

  • 推薦寫法
  • 不推薦寫法


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM