mpvue 單文件頁面配置

前言

mpvue 的出現把 vue 的開發體驗帶到了小程序這個平臺中,但其目錄結構與傳統的 vue 項目卻并不完全一致,一個典型的頁面包含以下三個文件:

index.vue // 頁面文件
main.js // 打包入口,完成 vue 的實例化
main.json // 小程序特有的頁面配置,早期寫在 main.js 文件中

其中,每個頁面的 main.js 文件基本都是一致的,可通過 mpvue-entry 來自動生成(weex 也有類似的處理),而 main.json 我個人認為直接在 vue 文件中配置更為合適,于是開發了 mpvue-config-loader 來加以實現

本文將介紹如何在 mpvue 官方模板的基礎上,通過配置 mpvue-config-loader 來實現在 vue 文件內書寫小程序的頁面配置

步驟

  1. 初始化項目
vue init mpvue/mpvue-quickstart my-project
  1. 安裝依賴
npm i mpvue-config-loader -D

or

yarn add mpvue-config-loader -D
  1. 修改打包配置
  • build/webpack.base.conf.js
module.exports = {
  module: {
    rules: [
      {
        test: /\.vue$/,
        loader: 'mpvue-loader',
        options: vueLoaderConfig
      },
+     {
+       test: /\.vue$/,
+       loader: 'mpvue-config-loader',
+       exclude: [resolve('src/components')],
+       options: {
+         entry: './main.js'
+       }
+     }
    ...
    ]
  }
  ...
  plugins: [
    new MpvuePlugin(),
-   new CopyWebpackPlugin([{
-     from: '**/*.json',
-     to: ''
-   }], {
-     context: 'src/'
-   }),
    ...
  ]
}
  1. 修改頁面配置
  • src/App.vue - 復制 app.json 中的內容,并修改格式以符合 eslint 規范
<script>
export default {
+ config: {
+   pages: [
+     'pages/index/main',
+     'pages/logs/main',
+     'pages/counter/main'
+   ],
+   window: {
+     backgroundTextStyle: 'light',
+     navigationBarBackgroundColor: '#fff',
+     navigationBarTitleText: 'WeChat',
+     navigationBarTextStyle: 'black'
+   }
+ },
  created () {
    ...
  }
}
  • src/pages/logs/index.vue - 同上
import { formatTime } from '@/utils/index'
import card from '@/components/card'

export default {
+ config: {
+   navigationBarTitleText: '查看啟動日志'
+ },
  ...
}
  • src/app.json - 刪除

  • src/pages/logs/main.json - 刪除

  1. 啟動運行
npm run dev

or

yarn dev

其他

  • app.vue 文件中可設置 globalConfig 屬性,其會與頁面配置進行合并,可實現全局引用原生組件

  • 使用 mpvue-entry 的項目暫不建議使用該模塊,后期會直接集成作為可選模式之一

  • 該模塊的實現方式有以下兩種可選,但由于前者在編輯器中暫無法高亮,所以采用了第二種方式

    • 自定義標簽 <config></config>
    • <script></script> 標簽導出對象的 config 屬性
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容