# 全局配置

Mpx.config 是一个对象,包含 Mpx 的全局配置。可以在启动应用之前修改下列 property:

# useStrictDiff

boolean = false

每次有数据变更时,是否使用严格的 diff 算法。如果项目中有大数据集的渲染建议使用,可以提升效率。

import mpx from '@mpxjs/core'
mpx.config.useStrictDiff = true

注意:由于微信小程序的bug,同时使用useStrictDiff和增强指令wx:style时,要注意更改数据的方式。如下所示:

// 入口文件
import mpx, { createApp } from '@mpxjs/core'
mpx.config.useStrictDiff = true

// 页面page文件
<template>
  <view>
    <view wx:style="{{style}}">test</view>
  </view>
</template>

<script>
  import { createPage } from '@mpxjs/core'
  createPage({
    data: {
      style: {
        color: 'red',
        fontSize: '18px'
      }
    },
    onLoad () {
      setTimeout(() => {
        this.setData({ // 当useStrictDiff设置true时,需要用setData的方式设置整个style对象
          style: {
            color: 'blue',
            fontSize: '18px'
          }
        })
        // this.style.color = 'blue' // 当useStrictDiff设置true时,不能使用这种方式,style不会生效
      }, 1000)
    }
  })
</script>

# ignoreWarning

boolean = false

是否忽略运行时的 warning 信息,默认不忽略。

import mpx from '@mpxjs/core'
mpx.config.ignoreWarning = true

# ignoreProxyWhiteList

Array<string> = ['id']

Mpx 实例上的 key(包括data、computed、methods)如果有重名冲突,在ignoreProxyWhiteList配置中的属性会被最新的覆盖;而不在ignoreProxyWhiteList配置中的属性,不会被覆盖。

只要有重名冲突均会有报错提示。

import mpx from '@mpxjs/core'
mpx.config.ignoreConflictWhiteList = ['id', 'test']

# observeClassInstance

boolean = false

当需要对 class 对象的数据进行响应性转化,需要开启该选项。

# proxyEventHandler

Function

需要代理的事件的钩子方法,该钩子方法仅对内联传参事件或 forceProxyEventRules 规则匹配的事件生效。

import mpx from '@mpxjs/core'

mpx.config.proxyEventHandler = function (event) {
    // 入参为 event 事件对象
}

# setDataHandler

function setDataHandler(data: object, target: ComponentIns<{}, {}, {}, {}, []>): any

页面/组件状态更新时,使用该方法可以对 setData 调用进行监听,可以用来统计 setData 调用次数和数据量的统计,方法的入参是 setData 传输的 data 和当前组件实例。

import mpx from '@mpxjs/core'

mpx.config.setDataHandler = function(data, comp) {
    console.log('setData trigger', data, comp)
}

# forceFlushSync

boolean = false

Mpx 中更改响应性状态时,最终页面的更新并不是同步立即生效的,而是由 Mpx 将它们缓存在一个队列中, 异步等到下一个 tick 一起执行,如果想将所有队列的执行改为同步执行,我们可以通过该配置来实现。

import mpx from '@mpxjs/core'

mpx.config.forceFlushSync = true

# errorHandler

Function

mpx.config.errorHandler = function (errmsg, location, error) {
  // errmsg: 框架内部运行报错的报错归类信息,例如当执行一个watch方法报错时,会是 "Unhandled error occurs during execution of watch callback!"
  // location: 具体报错的代码路径,可选项,不一定存在
  // error: 具体的错误堆栈,可选项,不一定存在
  // handle error
}

Mpx 框架运行时报错捕获感知处理函数。

  • Mpx 框架生命周期执行错误;
  • Mpx 中的 computed、watch 等内置方法执行报错;
  • Mpx 框架的运行时的检测报错,例如存在目标平台不支持的属性,入参出参类型错误等;

同时被捕获的错误会通过 console.error 输出。

# webRouteConfig

Mpx 通过 config 暴露出 webRouteConfig 配置项,在 web 环境可以对路由进行配置。 此配置后续将被废弃,请使用 webConfig 进行配置

  • 用法:
mpx.config.webRouteConfig = {
  mode: 'history'
}

# webConfig

web 环境下的一些配置,如路由模式,页面切换动画效果等

  • 用法:
// 修改路由模式
mpx.config.webConfig.routeConfig = {
  mode: 'history'
}
// 禁用页面切换动画
mpx.config.webConfig.disablePageTransition = true