单文件

介绍单文件编译开发特性，包括单文件中有哪些部分以及如何进行ide配置等

介绍

按照小程序的文件规范，app & page & component 的组成部分都是四个文件，js, wxss, wxml, json; 多文件的形式在开发上体验并不是特别友好，使用过vue的同学都知道，单文件的开发模式更内聚，更可维护。因此mpx也提供了单文件开发模式，文件扩展名为 .mpx

通过 webpack 构建工具和 mpx-loader 可以将文件扩展名为 .mpx 的 single file component 转换成小程序所需要的四个文件。

这四个文件对应于单文件中的四个区域

基础例子

  1. <!--对应wxml文件-->
  2. <template>
  3.   <view>hello mpx</view>
  4. </template>
  5. <!--对应js文件-->
  6. <script>
  7. </script>
  8. <!--对应wxss文件-->
  9. <style lang="stylus">
  10. </style>
  11. <!--对应json文件-->
  12. <script type="application/json">
  13. </script>

编辑器/IDE高亮、提示

IntelliJ

如果使用IntelliJ系IDE开发，可将mpx后缀文件关联到vue类型，按vue解析。关联文件类型但会报一个warning提示有重复的script标签，关闭该警告即可。关闭警告

vscode

.mpx采用类似于.vue的单文件语法风格，在Visual Studio Marketplace中获取vue语法高亮插件然后通过配置vscode扩展语言，将.mpx绑定到.vue语法的支持

下方的方案为社区同学贡献，通过更多的插件使用，可能在某些功能上有所增强，但也可能遇到一些其他问题，请个人判断是否需要

vscode插件

更新: minapp最新版已经支持了mpx，所以对minapp的使用加以修改

  1. minapp此插件主要功能是给template加上wxml的snippet功能，只要在 template 标签中添加属性minapp='mpx' xlang='wxml'就可以使用
  2. wechat-snippet，主要是使用里面的wx.xxx的snippet
  3. vetur主要使用其高亮和格式化功能，配套安装有prettier，新版配置为
  1.  "vetur.format.defaultFormatterOptions": {
  2.     "prettyhtml": {
  3.       "printWidth": 100, // No line exceeds 100 characters
  4.       "singleQuote": false // Prefer double quotes over single quotes
  5.     },
  6.     "prettier": {
  7.       // Prettier option here
  8.       "semi": false,
  9.       "singleQuote": true,
  10.       "eslintIntegration": true
  11.     }
  12.   }

注意:

  1. 当添加了xlang="wxml"后，可以使用vetur配置的template的格式化，但是会存在vue插件的snippet
  2. 在改成xlang="wxml"后，虽然能格式化了，但是image和input标签的格式化会出问题，所以最好在最后完成的时候，改回lang="wxml"关闭格式化
  3. 注意使用vscode的工作区功能，最好把vue插件相关提示先关闭了

  4. 因为mpx单文件具有两个script标签，直接格式化会出问题，需要

    1. <script  type='application/json' lang='json'>
    2. {
    3. "navigationBarTitleText": "",
    4. "usingComponents": {
    6. }
    7. }
    8. </script>

    如上，需要在json的script中，加上lang="json"这样就不会对这个标签进行格式化

vscode代码片段

此功能主要是为了新建文件后快速生成一些代码，只要在设置里，选择用户代码片段，在选择vue.json，将以下代码复制进去。之后只要输出写好的prefix，就能自动提示生成。如此你也可以对javascript.json做一些自定义的代码片段

"Print to weapp page": {
 "prefix": "page",
 "body": [
   "<template minapp='native' xlang='wxml'>",
   "  <view class='container'>\n",
   "  </view>",
   "</template>\n",
   "<script>",
   "import { createPage } from '@mpxjs/core'",
   "  createPage({",
   "    data: {",
   "    },",
   "    onShow() {",
   "      // 所在页面显示之后就会执行一次",
   "      console.log('page show')\n",
   "    },",
   "    onHide() {",
   "      // 页面切入后台执行",
   "     console.log('page hide')\n",
   "    },",
   "    methods: {\n",
   "    /**",
   "     * 页面相关事件处理函数--监听用户下拉动作",
   "    */",
   "    onPullDownRefresh() {},",
   "    /**",
   "     * 页面上拉触底事件的处理函数",
   "    */",
   "    onReachBottom() {},",
   "     /**",
   "       * 用户点击右上角分享",
   "     */",
   "    onShareAppMessage() {},",
   "    }",
   "  })",
   "</script>\n",
   "<style lang='scss'>\n",
   " .container {} ",
   "</style>",
   "<script  type='application/json' lang='json'>",
   "{",
   " \"navigationBarTitleText\": \"搜索\",",
   " \"usingComponents\": {}",
   "}",
   "</script>\n",
   "$2"
 ],
 "description": "weapp page"
},
"Print to weapp components": {
 "prefix": "components",
 "body": [
   "<template minapp='native' xlang='wxml'>",
   "  <view class='container'>\n",
   "  </view>",
   "</template>\n",
   "<script>",
   "import { createComponent } from '@mpxjs/core'",
   "  createComponent({",
   "    properties: {\n},",
   "    data: {",
   "    },",
   "    pageShow() {",
   "      // 所在页面显示之后就会执行一次",
   "      console.log('page show')\n",
   "    },",
   "    pageHide() {",
   "      // 页面切入后台执行",
   "     console.log('page hide')\n",
   "    },",
   "    methods: {\n",
   "    }",
   "  })",
   "</script>\n",
   "<style lang='scss'>\n",
   " .container {} ",
   "</style>",
   "<script  type='application/json' lang='json'>",
   "{ ",
   " \"component\": true",
   "}",
   "</script>\n",
   "$2"
 ],
 "description": "weapp components"
}