Skip to content

Commit

Permalink
doc: 补充选项式api options.shallowReactivePattern 文档
Browse files Browse the repository at this point in the history
  • Loading branch information
mackwang committed Jan 15, 2025
1 parent 28e6c9a commit 98a60c6
Showing 1 changed file with 52 additions and 0 deletions.
52 changes: 52 additions & 0 deletions docs-vuepress/api/optional-api.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,57 @@
# 选项式 API

### options.shallowReactivePattern
- **类型:** `RegExp`
- **详细:**

取消data/properties内数据的深度响应。

适用于每次更新均为整体的更新而非局部少量数据更新的大型数据,可减少掉对应属性“数据响应初始化”以及“diff比较”两个阶段的耗时

```html
<!-- child -->
<script>
createComponent({
properties: {
bigPropData: Object
},
data: {
// 这个是视图上需要用到的大数据
bigData: { a: 0 }
},
options: {
// 配置具体哪些data或者properties需要忽略响应
shallowReactivePattern: /bigData|bigPropData/
},
methods: {
foo() {
this.bigData = { a: 1 } // 可触发视图更新
},
bar() {
this.bigData.a = 2 // 不可触发视图更新
}
}
})
</script>

<!-- perant -->
<template>
<child bigPropData="{{parentBigData}}"/>
</template>
<script>
createComponent({
data: {
parentBigData: []
},
options: {
shallowReactivePattern: /parentBigData/ // 父组件中传入的data也需要开启shallowReactive
}
})
</script>
```

> 注意
### onAppInit
- **类型:** `Function`
- **详细:**
Expand Down

0 comments on commit 98a60c6

Please sign in to comment.