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
複製代碼

2. 安裝依賴

npm i mpvue-config-loader -D
複製代碼

or

yarn add mpvue-config-loader -D
複製代碼

3. 修改打包配置

• 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/'
- }),
    ...
  ]
}
複製代碼

4. 修改頁面配置

• 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 - 刪除

5. 啓動運行

npm run dev
複製代碼

or

yarn dev
複製代碼

其餘

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

• 使用 mpvue-entry 的項目暫不建議使用該模塊，後期會直接集成做爲可選模式之一

• 該模塊的實現方式有如下兩種可選，但因爲前者在編輯器中暫沒法高亮，因此採用了第二種方式

  • 自定義標籤 <config></config>
  • <script></script> 標籤導出對象的 config 屬性