## 应用配置 `config` 是一个包含了 `Vue` 应用全局配置的对象。你可以在应用挂载前修改其以下 `property`: ```js const app = Vue.createApp({}) app.config = {...} ``` |应用配置|描述 |H5 |App端|微信小程序 |说明 | |-- |-- |-- |-- |-- |-- | |errorHandler |指定一个处理函数,来处理组件渲染方法执行期间以及侦听器抛出的未捕获错误。[详情](https://v3.cn.vuejs.org/api/application-config.html#errorhandler) |√ |√ | √ || |warnHandler |为 `Vue` 的运行时警告指定一个自定义处理函数。[详情](https://v3.cn.vuejs.org/api/application-config.html#warnhandler) |√ |√ | √ || |globalProperties |添加可以在应用程序内的任何组件实例中访问的全局 `property`。[详情](https://v3.cn.vuejs.org/api/application-config.html#globalproperties) |√ |√ | √ || |isCustomElement |指定一个方法,用来识别在 `Vue` 之外定义的自定义元素。[详情](https://v3.cn.vuejs.org/api/application-config.html#iscustomelement) |√ |√ | √ || |optionMergeStrategies |为自定义选项定义合并策略。[详情](https://v3.cn.vuejs.org/api/application-config.html#optionmergestrategies) |√ |√ | √ || |performance|设置为 `true` 以在浏览器开发工具的 `performance/timeline` 面板中启用对组件初始化、编译、渲染和更新的性能追踪。[详情](https://v3.cn.vuejs.org/api/application-config.html#performance) |√ |x | x|只在Web环境下支持| ## 应用 API 在 Vue 3 中,改变全局 `Vue` 行为的 `API` 现在被移动到了由新的 `createApp` 方法所创建的应用实例上。此外,现在它们的影响仅限于该特定应用实例: ```js import { createApp } from 'vue' const app = createApp({}) ``` 调用 `createApp` 返回一个应用实例。该实例提供了一个应用上下文。应用实例挂载的整个组件树共享相同的上下文,该上下文提供了之前在 `Vue 2.x` 中“全局”的配置。 另外,由于 `createApp` 方法返回应用实例本身,因此可以在其后链式调用其它方法,这些方法可以在以下部分中找到。 |应用 API|描述 |H5 |App端|微信小程序 | |-- |-- |-- |-- |-- | |component |注册或检索全局组件。[详情](https://v3.cn.vuejs.org/api/application-api.html#component) |√ |√ | √ | |config |包含应用配置的对象。[详情](https://v3.cn.vuejs.org/api/application-api.html#config) |√ |√ | √ | |directive |注册或检索全局指令。[详情](https://v3.cn.vuejs.org/api/application-api.html#directive) |√ |√ |x | |mixin |在整个应用范围内应用混入。[详情](https://v3.cn.vuejs.org/api/application-api.html#mixin) |√ |√ | √ | |provide|设置一个可以被注入到应用范围内所有组件中的值。[详情](https://v3.cn.vuejs.org/api/application-api.html#provide) |√ |√ | √ | |use|安装 `Vue.js` 插件。[详情](https://v3.cn.vuejs.org/api/application-api.html#use) |√ |√ | √ | ## 全局 API |全局 API|描述 |H5 |App端|微信小程序 | |-- |-- |-- |-- |-- | |createApp |返回一个提供应用上下文的应用实例。应用实例挂载的整个组件树共享同一个上下文。[详情](https://v3.cn.vuejs.org/api/global-api.html#createapp) |√ |√ | √ | |h |返回一个”虚拟节点“,通常缩写为 `VNode`:一个普通对象,其中包含向 `Vue` 描述它应在页面上渲染哪种节点的信息,包括所有子节点的描述。[详情](https://v3.cn.vuejs.org/api/global-api.html#h) |√ |x | x | |defineComponent |从实现上看,`defineComponent` 只返回传递给它的对象。但是,就类型而言,返回的值有一个合成类型的构造函数,用于手动渲染函数、`TSX` 和 `IDE` 工具支持。[详情](https://v3.cn.vuejs.org/api/global-api.html#definecomponent) |√ |x | x | |defineAsyncComponent |创建一个只有在需要时才会加载的异步组件。[详情](https://v3.cn.vuejs.org/api/global-api.html#defineasynccomponent) |√ |x | x | |resolveComponent |如果在当前应用实例中可用,则允许按名称解析 `component`。返回一个 `Component`。[详情](https://v3.cn.vuejs.org/api/global-api.html#resolvecomponent) |√ |x | x | |resolveDynamicComponent|允许使用与 `component :is=""` 相同的机制来解析一个 `component`。[详情](https://v3.cn.vuejs.org/api/global-api.html#resolvedynamiccomponent) |√ |x | x | |resolveDirective|如果在当前应用实例中可用,则允许通过其名称解析一个 `directive`。返回一个 `Directive`。[详情](https://v3.cn.vuejs.org/api/global-api.html#resolvedirective) |√ |x | x | |withDirectives|允许将指令应用于 `VNode`。返回一个包含应用指令的 `VNode`。[详情](https://v3.cn.vuejs.org/api/global-api.html#withdirectives) |√ |x | x | |createRenderer|createRenderer 函数接受两个泛型参数: `HostNode` 和 `HostElement`,对应于宿主环境中的 `Node` 和 `Element` 类型。[详情](https://v3.cn.vuejs.org/api/global-api.html#createrenderer) |√ |x| x | |nextTick|将回调推迟到下一个 `DOM` 更新周期之后执行。在更改了一些数据以等待 `DOM` 更新后立即使用它。[详情](https://v3.cn.vuejs.org/api/global-api.html#nexttick) |√ | x | x | ## 选项/Data |Data|描述 |H5 |App端|微信小程序 | |-- |-- |-- |-- |-- | |data |返回组件实例的 `data` 对象的函数。[详情](https://v3.cn.vuejs.org/api/options-data.html) |√ |√ | √ | |props |`props` 可以是数组或对象,用于接收来自父组件的数据。[详情](https://v3.cn.vuejs.org/api/options-data.html#props) |√ |√ | √ | |computed |计算属性将被混入到组件实例中。所有 `getter` 和 `setter` 的 `this` 上下文自动地绑定为组件实例。[详情](https://v3.cn.vuejs.org/api/options-data.html#computed) |√ |√ | √ | |methods |methods 将被混入到组件实例中。可以直接通过 `VM` 实例访问这些方法,或者在指令表达式中使用。方法中的 `this` 自动绑定为组件实例。[详情](https://v3.cn.vuejs.org/api/options-data.html#methods) |√ |√ | √ | |watch |一个对象,键是需要观察的表达式,值是对应回调函数。值也可以是方法名,或者包含选项的对象。[详情](https://v3.cn.vuejs.org/api/options-data.html#watch) |√ |√ | √ | |emits|emits 可以是数组或对象,从组件触发自定义事件,`emits` 可以是简单的数组,或者对象作为替代,允许配置和事件验证。[详情](https://v3.cn.vuejs.org/api/options-data.html#emits) |√ |√ | √ | ## 选项/DOM |DOM|描述 |H5 |App端|微信小程序 |说明 | |-- |-- |-- |-- |-- |-- | |template |一个字符串模板作为 `component` 实例的标识使用。[详情](https://v3.cn.vuejs.org/api/options-dom.html#template) |√ |x | x |uni-app使用的vue是只包含运行时的版本 | |render |字符串模板的另一种选择,允许你充分利用 `JavaScript` 的编程功能。[详情](https://v3.cn.vuejs.org/api/options-dom.html#render) |√ | x | x | - | ## 选项/生命周期钩子 |生命周期钩子|描述 |H5 |App端|微信小程序 | |-- |-- |-- |-- |-- | |beforeCreate |在实例初始化之后,数据观测` (data observer) `和 `event/watcher` 事件配置之前被调用。[详情](https://v3.cn.vuejs.org/api/options-lifecycle-hooks.html#beforecreate) |√ |√ | √ | |created |在实例创建完成后被立即调用。[详情](https://v3.cn.vuejs.org/api/options-lifecycle-hooks.html#created) |√ |√ | √ | |beforeMount |在挂载开始之前被调用:相关的 `render` 函数首次被调用。[详情](https://v3.cn.vuejs.org/api/options-lifecycle-hooks.html#beforemount) |√ |√ | √ | |mounted |实例被挂载后调用,这时 `Vue.createApp({}).mount()` 被新创建的 `vm.$el` 替换了。[详情](https://v3.cn.vuejs.org/api/options-lifecycle-hooks.html#mounted) |√ |√ | √ | |beforeUpdate |数据更新时调用,发生在虚拟 `DOM` 打补丁之前。[详情](https://v3.cn.vuejs.org/api/options-lifecycle-hooks.html#beforeupdate) |√ |√ | √ | |updated|由于数据更改导致的虚拟 `DOM` 重新渲染和打补丁,在这之后会调用该钩子。[详情](https://v3.cn.vuejs.org/api/options-lifecycle-hooks.html#updated) |√ |√ | √ | |activated|被 `keep-alive` 缓存的组件激活时调用。[详情](https://v3.cn.vuejs.org/api/options-lifecycle-hooks.html#activated) |√ |√ | x | |deactivated|被 `keep-alive` 缓存的组件停用时调用。[详情](https://v3.cn.vuejs.org/api/options-lifecycle-hooks.html#deactivated) |√ |√ | x | |beforeUnmount|在卸载组件实例之前调用。在这个阶段,实例仍然是完全正常的。[详情](https://v3.cn.vuejs.org/api/options-lifecycle-hooks.html#beforeunmount) |√ |√ | √ | |unmounted|卸载组件实例后调用。调用此钩子时,组件实例的所有指令都被解除绑定,所有事件侦听器都被移除,所有子组件实例被卸载。[详情](https://v3.cn.vuejs.org/api/options-lifecycle-hooks.html#unmounted) |√ |√ | √ | |errorCaptured |当捕获一个来自子孙组件的错误时被调用。此钩子会收到三个参数:错误对象、发生错误的组件实例以及一个包含错误来源信息的字符串。[详情](https://v3.cn.vuejs.org/api/options-lifecycle-hooks.html#errorcaptured) |√ |√ | √ | |renderTracked |跟踪虚拟 `DOM` 重新渲染时调用。钩子接收 `debugger event` 作为参数。此事件告诉你哪个操作跟踪了组件以及该操作的目标对象和键。[详情](https://v3.cn.vuejs.org/api/options-lifecycle-hooks.html#rendertracked) |√ |√ | √ | |renderTriggered |当虚拟 `DOM` 重新渲染为 `triggered.Similarly` 为`renderTracked`,接收 `debugger event` 作为参数。此事件告诉你是什么操作触发了重新渲染,以及该操作的目标对象和键。[详情](https://v3.cn.vuejs.org/api/options-lifecycle-hooks.html#rendertriggered) |√ |√ | √ | ## 选项/资源 |资源|描述 |H5 |App端|微信小程序 | |-- |-- |-- |-- |-- | |directives |包含组件实例可用指令的哈希表。[详情](https://v3.cn.vuejs.org/api/options-assets.html#directives) |√ |√ |x | |components |包含组件实例可用组件的哈希表。[详情](https://v3.cn.vuejs.org/api/options-assets.html#components) |√ |√ | √ | ## 选项/组合 |组合|描述 |H5 |App端|微信小程序 | |-- |-- |-- |-- |-- | |mixins |接收一个混入对象的数组。这些混入对象可以像正常的实例对象一样包含实例选项,这些选项将会被合并到最终的选项中,使用特定的选项合并逻辑。[详情](https://v3.cn.vuejs.org/api/options-composition.html#mixins) |√ |√ | √ | |extends |允许声明扩展另一个组件 (可以是一个简单的选项对象或构造函数)。这主要是为了便于扩展单文件组件。[详情](https://v3.cn.vuejs.org/api/options-composition.html#extends) |√ |√ | √ | |provide / inject |这对选项需要一起使用,以允许一个祖先组件向其所有子孙后代注入一个依赖,不论组件层次有多深,并在起上下游关系成立的时间里始终生效。[详情](https://v3.cn.vuejs.org/api/options-composition.html#provide-inject) |√ |√ | √ | |setup |`setup` 函数是一个新的组件选项。它作为在组件内部使用组合式 `API` 的入口点。[详情](https://v3.cn.vuejs.org/api/options-composition.html#setup) |√ |√ | √ | ## 选项/杂项 |杂项|描述 |H5 |App端|微信小程序 | |-- |-- |-- |-- |-- | |name |允许组件模板递归地调用自身。注意,组件在全局用 `Vue.createApp({}).component({})` 注册时,全局 `ID` 自动作为组件的 `name`。[详情](https://v3.cn.vuejs.org/api/options-misc.html#name) |√ |√ | √ | |delimiters |设置用于模板内文本插入的分隔符。[详情](https://v3.cn.vuejs.org/api/options-misc.html#delimiters) |√ |x | x | |inheritAttrs |默认情况下父作用域的不被认作 `props` 的 `attribute` 绑定 (`attribute bindings`) 将会“回退”且作为普通的 `HTML attribute` 应用在子组件的根元素上。当撰写包裹一个目标元素或另一个组件的组件时,通过设置 `inheritAttrs` 到 `false`,这些默认行为将会被去掉。[详情](https://v3.cn.vuejs.org/api/options-misc.html#inheritattrs) |√ |√ | x | ## 实例 property |实例 property|描述 |H5 |App端|微信小程序 |说明 | |-- |-- |-- |-- |-- |-- | |$data |组件实例观察的数据对象。组件实例代理了对其 `data` 对象 `property` 的访问。[详情](https://v3.cn.vuejs.org/api/instance-properties.html#data) |√ |√ | √ || |$props |当前组件接收到的 `props` 对象。组件实例代理了对其 `props` 对象 `property` 的访问。[详情](https://v3.cn.vuejs.org/api/instance-properties.html#props) |√ |√ | √ || |$el |组件实例使用的根 `DOM` 元素。[详情](https://v3.cn.vuejs.org/api/instance-properties.html#el) |√ | x| x|| |$options |用于当前组件实例的初始化选项。需要在选项中包含自定义 `property` 时会有用处。[详情](https://v3.cn.vuejs.org/api/instance-properties.html#options) |√ |√ | √ || |$parent |父实例,如果当前实例有的话。[详情](https://v3.cn.vuejs.org/api/instance-properties.html#parent) |√ |√ | √ |H5端 `view`、`text` 等内置标签是以 `Vue` 组件方式实现,`$parent` 会获取这些到内置组件,导致的问题是 `this.$parent` 与其他平台不一致,解决方式是使用 `this.$parent.$parent` 获取或自定义组件根节点由 `view` 改为 `div`| |$root |当前组件树的根组件实例。如果当前实例没有父实例,此实例将会是其自己。[详情](https://v3.cn.vuejs.org/api/instance-properties.html#root) |√ |√ | √ || |$slots |用来访问被插槽分发的内容。每个具名插槽有其相应的 `property` (例如:`v-slot:foo` 中的内容将会在 `this.$slots.foo` 中被找到)。[详情](https://v3.cn.vuejs.org/api/instance-properties.html#slots) |√ |x | √ || |$refs |一个对象,持有注册过 `ref attribute` 的所有 `DOM` 元素和组件实例。[详情](https://v3.cn.vuejs.org/api/instance-properties.html#refs) |√ |√ | √|非H5端只能用于获取自定义组件,不能用于获取内置组件实例(如:`view`、`text`)| |$attrs |包含了父作用域中不作为组件 `props` 或自定义事件。[详情](https://v3.cn.vuejs.org/api/instance-properties.html#attrs) |√ |√ | x |-| ## 实例方法 |实例方法|描述 |H5 |App端|微信小程序 | |-- |-- |-- |-- |-- | |$watch |侦听组件实例上的响应式 `property` 或函数计算结果的变化。[详情](https://v3.cn.vuejs.org/api/instance-methods.html#watch) |√ |√ | √ | |$emit |触发当前实例上的事件。附加参数都会传给监听器回调。[详情](https://v3.cn.vuejs.org/api/instance-methods.html#emit) |√ |√ | √ | |$forceUpdate |迫使组件实例重新渲染。注意它仅仅影响实例本身和插入插槽内容的子组件,而不是所有子组件。[详情](https://v3.cn.vuejs.org/api/instance-methods.html#forceupdate) |√ |√ | √ | |$nextTick |将回调延迟到下次 `DOM` 更新循环之后执行。在修改数据之后立即使用它,然后等待 `DOM` 更新。[详情](https://v3.cn.vuejs.org/api/instance-methods.html#nexttick) |√ |√ | √ | ## 指令 |Vue 指令 |描述 |H5 |App端|微信小程序 |说明 | | -- | -- | -- |-- |-- | -- | |v-text | 更新元素的 `textContent`。 [详情](https://v3.cn.vuejs.org/api/directives.html#v-text) |√ |√ | √ | | |v-html | 更新元素的 `innerHTML`。 [详情](https://v3.cn.vuejs.org/api/directives.html#v-html) |√ | √ | x |微信小程序会被转成 `rich-text` | |v-show | 根据表达式的真假值,切换元素的 `display CSS property`。 [详情](https://v3.cn.vuejs.org/api/directives.html#v-show) |√ | √ | √ | | |v-if | 根据表达式的真假值来有条件地渲染元素。 [详情](https://v3.cn.vuejs.org/api/directives.html#v-if) |√ | √ | √ | | |v-else | 为 `v-if` 或者 `v-else-if` 添加`“else 块”`。[详情](https://v3.cn.vuejs.org/api/directives.html#v-else) |√ | √ | √ | | |v-else-if| 表示 `v-if` 的`“else if 块”`。可以链式调用。 [详情](https://v3.cn.vuejs.org/api/directives.html#v-else-if) |√ | √ | √ | | |v-for | 基于源数据多次渲染元素或模板块。 [详情](https://v3.cn.vuejs.org/api/directives.html#v-for) |√ | √ | √ | | |v-on | 绑定事件监听器。 [详情](https://v3.cn.vuejs.org/api/directives.html#v-on) |√ | √ | √ | | |v-bind | 动态地绑定一个或多个 `attribute`,或一个组件 `prop` 到表达式。 [详情](https://v3.cn.vuejs.org/api/directives.html#v-bind) |√ | √ | √ || |v-model| 在表单控件或者组件上创建双向绑定。 [详情](https://v3.cn.vuejs.org/api/directives.html#v-model) |√ | √ | √ | | |v-slot | 提供具名插槽或需要接收 `prop` 的插槽。 [详情](https://v3.cn.vuejs.org/api/directives.html#v-slot) |√ | √ | √ | | |v-pre | 跳过这个元素和它的子元素的编译过程。 [详情](https://v3.cn.vuejs.org/api/directives.html#v-pre) |√ | √ | x | | |v-cloak| 这个指令保持在元素上直到关联组件实例结束编译。 [详情](https://v3.cn.vuejs.org/api/directives.html#v-cloak) |√ | x | x | | |v-once | 只渲染元素和组件一次。 [详情](https://v3.cn.vuejs.org/api/directives.html#v-once) |√ | √ | x | | |v-is | 在 `DOM` 内模板使用时,模板受原生 `HTML` 解析规则的约束。 [详情](https://v3.cn.vuejs.org/api/directives.html#v-is) |√ | x | x | - | ## 特殊属性 |特殊属性 |描述 |H5 |App端|微信小程序 |说明 | | -- | -- | -- |-- |-- | -- | |key | `key` 的特殊 `attribute` 主要用在 `Vue` 的虚拟 `DOM` 算法,在新旧 `nodes` 对比时辨识 `VNodes`。 [详情](https://v3.cn.vuejs.org/api/special-attributes.html#key) |√ | √ | √ | | |ref | ref 被用来给元素或子组件注册引用信息。 [详情](https://v3.cn.vuejs.org/api/special-attributes.html#ref) |√ | √ | √ |非 H5 平台只能获取 `vue` 组件实例不能获取到内置组件实例| |is | 使用[动态组件](https://v3.cn.vuejs.org/guide/component-dynamic-async.html)。 [详情](https://v3.cn.vuejs.org/api/special-attributes.html#is) |√ | √ | x | - | ## 内置组件 |内置组件 |描述 |H5 |App端|微信小程序 | | -- | -- | -- |-- |-- | |component | 渲染一个“元组件”为动态组件。依 `is` 的值,来决定哪个组件被渲染。 [详情](https://v3.cn.vuejs.org/api/built-in-components.html#component) |√ | √ | x | | |transition | 作为单个元素/组件的过渡效果。 [详情](https://v3.cn.vuejs.org/api/built-in-components.html#transition) |√ | x | x | | |transition-group | 作为多个元素/组件的过渡效果。 [详情](https://v3.cn.vuejs.org/api/built-in-components.html#transition-group) |√ | x | x | | |keep-alive | 包裹动态组件时,会缓存不活动的组件实例,而不是销毁它们,主要用于保留组件状态或避免重新渲染。 [详情](https://v3.cn.vuejs.org/api/built-in-components.html#keep-alive) |√ |x | x | | |slot | 作为组件模板之中的内容分发插槽。`slot` 元素自身将被替换。 [详情](https://v3.cn.vuejs.org/api/built-in-components.html#slot) |√ | √ | √ | | |teleport | 将模板的一部分移动到 `DOM` 中 `Vue app` 之外的其他位置。 [详情](https://v3.cn.vuejs.org/api/built-in-components.html#teleport) |√ | x | x | - | ## 响应性 API ### 响应性基础 API |响应性基础 API|描述 |H5 |App端|微信小程序 | |-- |-- |-- |-- |-- | |reactive |返回对象的响应式副本。[详情](https://v3.cn.vuejs.org/api/basic-reactivity.html#reactive) |√ |√ | √ | |readonly |获取一个对象 (响应式或纯对象) 或 `ref` 并返回原始代理的只读代理。[详情](https://v3.cn.vuejs.org/api/basic-reactivity.html#readonly) |√ |√ | √ | |isProxy |检查对象是 `reactive` 还是 `readonly`创建的代理。[详情](https://v3.cn.vuejs.org/api/basic-reactivity.html#isproxy) |√ |√ | √ | |isReactive |检查对象是否是 `reactive`创建的响应式 `proxy`。[详情](https://v3.cn.vuejs.org/api/basic-reactivity.html#isreactive) |√ |√ | √ | |isReadonly |检查对象是否是由`readonly`创建的只读代理。[详情](https://v3.cn.vuejs.org/api/basic-reactivity.html#isreadonly) |√ |√ | √ | |toRaw |返回 `reactive` 或 `readonly` 代理的原始对象。[详情](https://v3.cn.vuejs.org/api/basic-reactivity.html#toraw) |√ |√ | √ | |markRaw |标记一个对象,使其永远不会转换为代理。返回对象本身。[详情](https://v3.cn.vuejs.org/api/basic-reactivity.html#markraw) |√ |√ | √ | |shallowReactive |创建一个响应式代理,该代理跟踪其自身 `property` 的响应性,但不执行嵌套对象的深度响应式转换 (暴露原始值)。[详情](https://v3.cn.vuejs.org/api/basic-reactivity.html#shallowreactive) |√ |√ | √ | |shallowReadonly |创建一个代理,使其自身的 `property` 为只读,但不执行嵌套对象的深度只读转换 (暴露原始值)。[详情](https://v3.cn.vuejs.org/api/basic-reactivity.html#shallowreadonly) |√ |√ | √ | ### Refs |Refs|描述 |H5 |App端|微信小程序 | |-- |-- |-- |-- |-- | |ref |接受一个内部值并返回一个响应式且可变的 `ref` 对象。`ref` 对象具有指向内部值的单个 property `.value`。[详情](https://v3.cn.vuejs.org/api/refs-api.html#ref) |√ |√ | √ | |unref |如果参数为 `ref`,则返回内部值,否则返回参数本身。这是 `val = isRef(val) ? val.value : val`。[详情](https://v3.cn.vuejs.org/api/refs-api.html#unref) |√ |√ | √ | |toRef |可以用来为源响应式对象上的 `property` 性创建一个 `ref`。然后可以将 `ref` 传递出去,从而保持对其源 `property` 的响应式连接。[详情](https://v3.cn.vuejs.org/api/refs-api.html#toref) |√ |√ | √ | |toRefs |将响应式对象转换为普通对象,其中结果对象的每个 `property` 都是指向原始对象相应 `property` 的`ref`。[详情](https://v3.cn.vuejs.org/api/refs-api.html#torefs) |√ |√ | √ | |isRef |检查值是否为`ref`对象[详情](https://v3.cn.vuejs.org/api/refs-api.html#isref) |√ |√ | √ | |customRef |创建一个自定义的 `ref`,并对其依赖项跟踪和更新触发进行显式控制。[详情](https://v3.cn.vuejs.org/api/refs-api.html#customref) |√ |√ | √ | |shallowRef |创建一个 `ref`,它跟踪自己的 `.value` 更改,但不会使其值成为响应式的。[详情](https://v3.cn.vuejs.org/api/refs-api.html#shallowref) |√ |√ | √ | |triggerRef |手动执行与 `shallowRef` 关联的任何效果。[详情](https://v3.cn.vuejs.org/api/refs-api.html#triggerref) |√ |√ | √ | ### Computed 与 watch |Computed 与 watch|描述 |H5 |App端|微信小程序 | |-- |-- |-- |-- |-- | |computed |使用 `getter` 函数,并为从 `getter` 返回的值返回一个不变的响应式 `ref` 对象。[详情](https://v3.cn.vuejs.org/api/computed-watch-api.html#computed) |√ |√ | √ | |watchEffect |在响应式地跟踪其依赖项时立即运行一个函数,并在更改依赖项时重新运行它。[详情](https://v3.cn.vuejs.org/api/computed-watch-api.html#watcheffect) |√ |√ | √ | |watch |`watch` API 与选项式 API `this.$watch` (以及相应的 `watch` 选项) 完全等效。`watch` 需要侦听特定的 `data` 源,并在单独的回调函数中副作用。[详情](https://v3.cn.vuejs.org/api/computed-watch-api.html#watch) |√ |√ | √ | ## 组合式 API |组合式 API|描述 |H5 |App端|微信小程序 | |-- |-- |-- |-- |-- | |setup |一个组件选项,在创建组件之前执行,一旦 `props` 被解析,并作为组合式 `API` 的入口点。[详情](https://v3.cn.vuejs.org/api/composition-api.html#setup) |√ |√ | √ | |生命周期钩子 |可以使用直接导入的 `onX` 函数注册生命周期钩子。[详情](https://v3.cn.vuejs.org/api/composition-api.html#%E7%94%9F%E5%91%BD%E5%91%A8%E6%9C%9F%E9%92%A9%E5%AD%90) |√ |√ | √ | |Provide / Inject |provide 和 inject 启用依赖注入。只有在使用当前活动实例的 `setup()` 期间才能调用这两者。[详情](https://v3.cn.vuejs.org/api/composition-api.html#provide-inject) |√ |√ | √ | |getCurrentInstance |允许访问对高级使用或库创建者有用的内部组件实例。[详情](https://v3.cn.vuejs.org/api/composition-api.html#getcurrentinstance) |√ |√ | √ | ## 全局变量 实现全局变量的方式需要遵循 `Vue` 单文件模式的开发规范。详细参考:[uni-app全局变量的几种实现方式](https://ask.dcloud.net.cn/article/35021)。 ## 其他配置 `Vue` 组件编译到小程序平台的时候会编译为对应平台的组件,部分小程序平台支持 `options` 选项(具体选项参考对应小程序平台文档的自定义组件部分),一般情况默认即可,如有特殊需求可在 `Vue` 组件中增加 `options` 属性。 ```js export default { props: ['data'], data(){ return { } }, options: { // 微信小程序中 options 选项 multipleSlots: true, // 在组件定义时的选项中启动多slot支持,默认启用 styleIsolation: "isolated", // 启动样式隔离。当使用页面自定义组件,希望父组件影响子组件样式时可能需要配置。具体配置选项参见:微信小程序自定义组件的样式 addGlobalClass: true, // 表示页面样式将影响到自定义组件,但自定义组件中指定的样式不会影响页面。这个选项等价于设置 styleIsolation: apply-shared virtualHost: true, // 将自定义节点设置成虚拟的,更加接近Vue组件的表现。我们不希望自定义组件的这个节点本身可以设置样式、响应 flex 布局等,而是希望自定义组件内部的第一层节点能够响应 flex 布局或者样式由自定义组件本身完全决定 } } ``` ## 常见问题 ### 1. 如何获取上个页面传递的数据 在 `onLoad` 里得到,`onLoad` 的参数是其他页面打开当前页面所传递的数据。 ### 2. 如何设置全局的数据和全局的方法 `uni-app` 内置了 [Vuex](https://uniapp.dcloud.io/vue-vuex) ,在`app`里的使用,可参考 `hello-uniapp` ` store/index.js`。 ```javaScript //store.js import {createStore} from 'vuex' const store = createStore({ state: {...}, mutations: {...}, actions: {...} }) export default store //main.js import App from './App' import {createSSRApp} from 'vue' import store from './store' export function createApp() { const app = createSSRApp(App) app.use(store) return { app } } //test.vue 使用时: import {mapState,mapMutations} from 'vuex' ``` ### 3. 如何捕获 app 的 onError 由于 `onError` 并不是完整意义的生命周期,所以只提供一个捕获错误的方法,在 `app` 的根组件上添加名为 `onError` 的回调函数即可。如下: ```javaScript export default { // 只有 app 才会有 onLaunch 的生命周期 onLaunch () { // ... }, // 捕获 app error onError (err) { console.log(err) } } ``` ### 4. 组件属性设置不生效解决办法 当重复设置某些属性为相同的值时,不会同步到`view`层。 例如:每次将`scroll-view`组件的`scroll-top`属性值设置为0,只有第一次能顺利返回顶部。 这和`props`的单向数据流特性有关,组件内部`scroll-top`的实际值改动后,其绑定的属性并不会一同变化。 解决办法有两种(以`scroll-view`组件为例): 1.监听`scroll`事件,记录组件内部变化的值,在设置新值之前先设置为记录的当前值 ```html ``` ```javaScript export default { data() { return { scrollTop: 0, old: { scrollTop: 0 } } }, methods: { scroll: function(e) { this.old.scrollTop = e.detail.scrollTop }, goTop: function(e) { this.scrollTop = this.old.scrollTop this.$nextTick(function() { this.scrollTop = 0 }); } } } ``` 2.监听scroll事件,获取组件内部变化的值,实时更新其绑定值 ```html ``` ```js export default { data() { return { scrollTop: 0, } }, methods: { scroll: function(e) { // 如果使用此方法,请自行增加防抖处理 this.scrollTop = e.detail.scrollTop }, goTop: function(e) { this.scrollTop = 0 } } } ``` 第二种解决方式在某些组件可能造成抖动,**推荐第一种解决方式**。