common-mpvue
TypeScript icon, indicating that this package has built-in type declarations

0.4.9 • Public • Published

MPVue 开发小程序的通用能力封装

Promisify 的 wx API

import { wxp } from 'common-mpvue';
 
wxp.request({ ...config }).then(resp => {
    // do something
});

可持久化至小程序 storage 的 VueStore

import { PersistStore } from 'common-mpvue';
 
const store = new PersistStore(storageKey, {
    ...storeOptions
});

Emitter

方便不同页面间通信,为保证同一个 emitter 实例,请通过getApp().emitter获取这个绑定在 app 下的 emitter 实例

const app = getApp();
 
// 添加监听
app.emitter.on('event1', function() {});
 
// 添加一次性监听
app.emitter.once('event1', function() {});
 
// 移除监听
app.emitter.off('event1', listener);
 
// 移除全部监听
app.emitter.offAll('event1');

Navigator

解决了页面栈过大时无法跳转的问题,自动使用redirectTo替代navigateTo

const app = new App();
 
app.nav.navigateTo('/pages/index/index', { param1: '1' });
 
app.nav.navigateToH5('https://example.com');
// 注意配置小程序webview页面 /pages/webview/webview

Utilities

提供少量的实用方法

const app = getApp();
 
// 给url添加query参数
app.utils.addUrlQuery('/pages/index/index', { param1: '1' });
// => /pages/index/index?param1=1
 
// 解析url的query为对象
app.utils.parseUrlQuery('/pages/index/index?param1=1');
// => {param1: 1}

Request

提供了封装的 Request 对象,适度的请求队列管理,建议使用wx.httpRequestwxp.httpRequest这个绑定在全局变量下的固定实例

wx.httpRequest.httpGet('https://example.com', { param1: '1' });
 
// json形式post
wx.httpRequest.httpJsonPost('https://example.com', { data1: '1' }, { ...requestOptions });
 
// form表单形式post
wx.httpRequest.httpFormPost('https://example.com', { data1: '1' }, { ...requestOptions });
 
// httpPost等同httpFormPost
wx.httpRequest.httpPost('https://example.com', { data1: '1' }, { ...requestOptions });

为了减少重复填写配置,可以重新实例化一个有固定配置的请求实例

// 配置请求携带token并以cookie形式传递
const httpRequest = wx.httpRequest
    .auth()
    .cookieToken()
    .form();
 
httpRequest.GET('https://example.com');
 
httpRequest.POST('https://example.com', { data1: '1' });

目前支持如下配置链

  • auth - 携带 token 用于鉴权,auth(true)
  • tokenKey - 携带 token 的 key,tokenKey('key')
  • headerToken - 通过 header 携带 token
  • cookieToken - 通过 cookie 携带 token
  • qsToken - 通过 url query 携带 token
  • form - 通过 form 表单形式 post
  • custom - 携带自定义 header 头,包含设备信息等

按照约定优于配置的原则,推荐数据接口有统一约定的响应

推荐格式

{
    code: 200, // 200API200http statuscodestatus
    loginCode: 200, // loginCode200loginCode便
    message: "", // message便promise catch
    data: {
        posts: [],
        total: 100
    }
}

说明

为了将这些能力引入到 app,wx,wxp 等对象上,需要按如下操作:

入口 main.js

import { wrap } from 'common-mpvue';
import App from './index.vue';
 
wrap(App, appConfig, appProps);
 
wrap的签名如下
 
/**
 * 封装和扩展小程序app实例以及wx
 * @param App 入口的Vue组件
 * @param config app配置
 * @param props 给app实例扩展更多的方法或属性
 */
wrap(App, configAppConfig, props?: BaseKV)
 
interface AppConfig {
    // 小程序名称
    name: string;
    // 小程序版本
    version: string;
    // 小程序工程package.json中的name
    pkgName: string;
    // 开发环境
    env?: 'production' | 'development';
    // api域名
    domain?: string;
    // 使用app.logger可上报信息的API
    reportDomain?: string;
    // 用于展示H5的页面,例如/pages/webview/webview
    webviewSchema?: string;
}

页面 main.js

import { WrapPage } from 'common-mpvue';
import Page from './index.vue';
 
new WrapPage(Page);
 
// 或者为页面添加vuex store
new WrapPage(Page, {
    state() {
        name: '';
    },
    mutations: {
        updateName(state, name) {
            state.name = name;
        }
    }
});

在页面的 vue 单文件组件内,可以通过this.$app访问小程序 app 实例,可以通过this.$store访问共享的业务 vuex store,可以通过this.$state访问该页面的状态模块

Package Sidebar

Install

npm i common-mpvue

Weekly Downloads

2

Version

0.4.9

License

MIT

Unpacked Size

165 kB

Total Files

39

Last publish

Collaborators

  • thundernet8