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 属性
阅读 1.8k更新于 2018-12-06
推荐阅读
目录