Reconciler

title: Reconciler

Taro 的运行时包括 DOM、BOM、React 兼容层、Vue 兼容层等内容，而不同的端平台或开发框架都有可能需要对 Taro 运行时进行侵入定制。

为了解耦，我们参考了 React Reconciler 的概念，外部可以通过提供一个自定义的 hostConfig 配置对象，对运行时进行定制。

遇到 hostConfig 的配置项不满足需求，需要进行扩展时，可以给 Taro 提交 PR～

hostConfig 配置

appendChild (parent, child)

DOMNode 调用 appendChild 方法时触发。

removeChild (parent, child, oldChild)

DOMNode 调用 replaceChild 方法时触发。

insertBefore (parent, child, refChild)

DOMNode 调用 insertBefore 方法时触发。

removeAttribute (element, qualifiedName)

DOMElement 调用 removeAttribute 方法时触发。

setAttribute (element, qualifiedName, value)

DOMElement 调用 setAttribute 方法时触发。

prepareUpdateData (data, page)

每次 Taro DOM 树更新，调用小程序 setData 前触发。

appendInitialPage (data, page)

Taro DOM 树初始化，第一次调用小程序 setData 前触发。在调用 prepareUpdateData 后立刻执行。

getLifecyle (instance, lifecyle)

小程序页面的生命周期被触发时调用。

需要返回 function 或 function[]，表示将要执行的函数。

例子：

// 默认值：
// 直接取用户编写的页面实例中，对应的生命周期方法
getLifecyle (instance, lifecyle) {
  return instance[lifecyle]
}
// 在 React 中，
// 小程序触发 onShow，调用用户编写的 componentDidShow
// 小程序触发 onHide，调用用户编写的 componentDidHide
getLifecyle (instance, lifecycle) {
  if (lifecycle === 'onShow') {
    lifecycle = 'componentDidShow'
  } else if (lifecycle === 'onHide') {
    lifecycle = 'componentDidHide'
  }
  return instance[lifecycle]
}

onTaroElementCreate (tagName, nodeType)

DOMElement 构造时触发。

getPathIndex (indexOfNode)

DOMNode 获取 path 属性时触发。

需要返回一个 string 值，代表小程序按路径 setData 时的数组下标。

例子：

// 默认值：
getPathIndex (indexOfNode) {
  return `[${indexOfNode}]`
}
// 百度小程序不需要 [] 包裹
getPathIndex (indexOfNode) {
  return indexOfNode
}

getEventCenter(Events)

Taro.eventCenter 初始化值时触发。

需要返回 Taro 事件中心的实例，其将会被赋值给 Taro.eventCenter。

例子：

// 默认值：
getEventCenter (Events) {
  return new Events()
}
// 支付宝小程序中，
// 优先从小程序全局对象 my 中取出创建过的事件中心实例，避免分包时出现问题。
getEventCenter (Events) {
  if (!my.taroEventCenter) {
    my.taroEventCenter = new Events()
  }
  return my.taroEventCenter
}

initNativeApi (taro)

引用 @tarojs/taro 包时触发。

例子：

initNativeApi (taro) {
  // 为 Taro 对象增加 getApp 方法
  taro.getApp = getApp
}