深圳手机网站建设牛商网,社区主题wordpress,建设网站的规划书,免费网站建设步骤Vue官方已经发布了Vue3#xff0c;Vue2不再维护#xff0c;也在建议大家都迁移到Vue3#xff0c;所以Vue2终会被淘汰。
那么UniApp 从Vue2升级为Vue3需要注意哪些方面#xff1a;
1、main.js
下面请看创建应用实例Vue2与Vue3的不同#xff1a;
Vue2的写法#xff1a;…Vue官方已经发布了Vue3Vue2不再维护也在建议大家都迁移到Vue3所以Vue2终会被淘汰。
那么UniApp 从Vue2升级为Vue3需要注意哪些方面
1、main.js
下面请看创建应用实例Vue2与Vue3的不同
Vue2的写法
// 之前 - Vue 2
import Vue from vue
import App from ./App
Vue.config.productionTip false // vue3 不再需要
App.mpType app // vue3 不再需要
const app new Vue({
...App
})
app.$mount()
Vue3的写法
import App from ./App
import { createSSRApp } from vue
// 不能修改导出的 createApp 方法名不能修改从 Vue 中导入的 createSSRApp。
export function createApp() {const app createSSRApp(App)return {app}
}
2、环境变量
Vue2的写法
// 配置环境变量
// 根目录.env文件 必须 VUE_APP_ 开头
VUE_APP_SOME_KEY 123// 获取环境变量
process.env.NODE_ENV // 应用运行的模式
process.env.VUE_APP_SOME_KEY // 123
Vue3的写法
// 配置环境变量
// 根目录.env文件 必须 VITE_ 开头
VITE_SOME_KEY 123// 获取环境变量
process.env.NODE_ENV // 应用运行的模式
import.meta.env.VITE_SOME_KEY // 123
注意“VITE”Vue3用的编译器是viteVue2用的编译器是webpack这只是部分举例具体看UniApp的官方文档。
3、全局属性
以全局网络请求为例
Vue2的写法
// 之前 - Vue 2
Vue.prototype.$http () {}; Vue3的写法
// 之后 - Vue 3
const app createApp({});
app.config.globalProperties.$http () {}; 4、插件使用
以使用 vuex 的 store为例
Vue2的写法
// 之前 - Vue 2
import store from ./store;
Vue.prototype.$store store; Vue3的写法
// 之后 - Vue 3
import store from ./store;
const app createApp(App);
app.use(store); 5、只支持使用 ES6 模块规范
commonJS 需改为 ES6 模块规范下面举例说明
5.1 以模块导入为例
Vue2的写法
// 之前 - Vue 2, 使用 commonJS
var utils require(../../../common/util.js);
Vue3的写法
// 之后 - Vue 3 只支持 ES6 模块
import utils from ../../../common/util.js;
5.2 以模块导出为例
Vue2的写法
// 之前 - Vue 2, 依赖如使用 commonJS 方式导出
module.exports.X X;
Vue3的写法
// 之后 - Vue 3 只支持 ES6 模块
export default { X };
6、vuex 用法
Vue2的写法
import Vue from vue;
import Vuex from vuex;
Vue.use(Vuex);
const store new Vuex.Store({state: {},
});
export default store;
Vue3的写法
import { createStore } from vuex;
const store createStore({state: {},
});
export default store;
7、避免在同一元素上同时使用 v-if 与 v-for
8、生命周期的适配 在 Vue3 中组件卸载的生命周期被重新命名
destroyed 修改为 unmounted beforeDestroy 修改为 beforeUnmount
注如上变化应该是适应Vue3的统一掉没有必要各一套的
注意created 和 onLoad 生命周期执行顺序
created为组件生命周期onLoad为页面生命周期。因此created执行先于onLoad更合理。
Vue3 在实现时 created 先于 onLoad 执行Vue2 项目由于历史包袱较重不便修改仅在使用组合式API时与Vue3对齐。
在编写代码时不应依赖 created 和 onLoad 生命周期执行顺序
9、事件的适配
Vue3 现在提供了一个emits选项类似于现有props选项。此选项可用于定义组件可以向其父对象发出的事件。
强烈建议使用emits记录每个组件发出的所有事件。
这一点特别重要因为去除了.native修饰符。emits 现在在未使用声明的事件的所有侦听器都将包含在组件的中$attrs默认情况下该侦听器将绑定到组件的根节点。
演示如下
templatebutton clickonClickOK/button
/template
scriptexport default {emits: [click],methods: {onClick() {this.$emit(click, OK);},},};
/script
10、Vue3 项目部分小程序端事件延迟或调用失败 可在执行事件的元素上添加 data-eventsynctrue 属性以解决此问题如
templatebutton clickonClick data-eventsynctrueOK/button
/template
11、v-model 的适配
Vue3 的 v-model 相对 Vue2 来说 有了较大的改变。可以使用多 model,相应语法也有变化。
12、修改 modelValue
用于自定义组件时Vue3 v-model prop 和事件默认名称已更改 props.value 修改为 props.modelValue ,event.value 修改为 update:modelValue
代码如下
export default {props: {// value:String,// 替换 value 为 modelValuemodelValue: String,},
};
13、事件返回
将之前的 this.$emit(input) 修改为 this.$emit(update:modelValue) vue3 中将省略这一步骤
自定义组件上的 v-model 相当于传递了 modelValue prop 并接收抛出的 update:modelValue 事件
ChildComponent v-modelpageTitle /!-- 是以下的简写: --ChildComponent:modelValuepageTitleupdate:modelValuepageTitle $event
/
若需要更改 model 名称作为组件内 model 选项的替代现在我们可以将一个 argument 传递给 v-model
ChildComponent v-model:titlepageTitle /!-- 是以下的简写: --ChildComponent :titlepageTitle update:titlepageTitle $event / 14、插槽的适配
Vue3 将不支持 slotxxx 的用法 请使用 v-slot:xxx 用法。
Vue2的写法
!-- Vue2 支持的用法 --
uni-nav-barview slotleft classcity!-- ... --/view
/uni-nav-bar
Vue3的写法
!-- Vue3 支持的用法 --
uni-nav-bartemplate v-slot:leftview classcity!-- ... --/view/template
/uni-nav-bar
15、不再支持过滤器
从 Vue 3.0 开始过滤器已删除不再支持建议用方法调用或计算属性替换它们。
16、API Promise 化 调用结果的方式
在 Vue3 中处理 API Promise 化 调用结果的方式不同于 Vue2。
Vue3 中调用成功会进入 then 方法调用失败会进入 catch 方法Vue2 中调用无论成功还是失败都会进入 then 方法返回数据的第一个参数是错误对象第二个参数是返回数据 具体转换方法如下
Vue 2 转 Vue 3
// Vue 2 转 Vue 3, 在 main.js 中写入以下代码即可
function isPromise(obj) {return (!!obj (typeof obj object || typeof obj function) typeof obj.then function);
}uni.addInterceptor({returnValue(res) {if (!isPromise(res)) {return res;}return new Promise((resolve, reject) {res.then((res) {if (!res) {resolve(res)return;}if (res[0]) {reject(res[0]);} else {resolve(res[1]);}});});},
});16、生命周期钩子的组合式 API 使用方式
在 Vue3 组合式 API 中也需要遵循 uni-app 生命周期钩子规范, 如 onLaunch 等应用生命周期仅可在 App.vue 中监听使用中请注意生命周期钩子的适用范围。
只能在 script setup 单文件语法糖或 setup() 方法中使用生命周期钩子以 A 页面跳转 B 页面传递参数为例
方法1:
// 从 A 页面跳转 B 页面时传递参数 ?id1nameuniappxxx 为跳转的页面路径
//uni.navigateTo({
// url: xxx?id1nameuniapp
//})// 方法一在 B 页面 script setup 中
script setupimport {onLoad,onShow} from dcloudio/uni-app;// onLoad 接受 A 页面传递的参数onLoad((option) {console.log(B 页面 onLoad:, option); //B 页面 onLoad: {id: 1, name: uniapp}});onShow(() {console.log(B 页面 onShow);});
/script方法二
// 方法二在 B 页面 setup() 中
scriptimport {onLoad,onShow,} from dcloudio/uni-app;export default {setup() {// onLoad 接受 A 页面传递的参数onLoad((option) {console.log(B 页面 onLoad:, option); //B 页面 onLoad: {id: 1, name: uniapp}});onShow(() {console.log(B 页面 onShow);});}}
/script17、$mp 调整为 $scope
在 Vue3 中this 对象下的 $mp 调整为 $scope 18、在 nvue 使用 Vuex
在 Vue3 中如果 nvue 使用了 Vuex 的相关 API需要在 main.js 的 createApp 的返回值中 return 一下 Vuex 示例
import Vuex from vuex;
export function createApp() {const app createSSRApp(App);app.use(store);return {app,Vuex, // 如果 nvue 使用 vuex 的各种map工具方法时必须 return Vuex};
}
19、需主动开启 sourcemap
App小程序端源码调试需要在 vite.config.js 中主动开启 sourcemap代码如下
import { defineConfig } from vite;
import uni from dcloudio/vite-plugin-uni;/*** type {import(vite).UserConfig}*/export default defineConfig({build: {sourcemap: true,},plugins: [uni()],
});20、小程序平台
20.1 监听原生的点击事件
在 vue3 的小程序平台中监听原生的点击事件可以先使用 tap。 在 vue3 中移除了.native 修饰符所以编译器无法预知 click 是要触发原生事件还是组件的自定义事件故并未转换成小程序的 tap 事件。 20.2 style
vue3 出于性能考虑style 中暂不支持 div、p 等 HTML 标签选择器推荐使用 class 选择器template 中的 HTML 标签仍会进行转换。
20.3 真机调试
vue3 微信开发者工具真机调试页面空白vue3 微信小程序真机调试
均可以通过在 manifest.json 的 mp-weixin 中配置 minified 为 true 来解决代码如下
{mp-weixin: {setting: {// ...其他配置minified: true}}
}21、vue3 支持的手机版本最低到多少
vue3 支持的范围是Android 4.4具体因系统 webview 版本而异原生安卓系统升级过系统 webview 一般 5.0 即可国产安卓系统未使用 x5 内核时一般需 7.0 以上, ios 10。
Android 4.4配置 X5 内核支持首次需要联网下载可以配置下载 X5 内核成功后启动应用。
22、vue3 nvue 暂不支持 recycle-list 组件
23、h5 平台发行时会默认启动摇树
vue3 在 h5 平台发行时为了优化包体积大小会默认启动摇树仅打包明确使用的 api 如果要关闭摇树可以在 manifest.json 中配置
h5: {optimization: {treeShaking: {enable: false}}
}24、通过 props 来获取页面参数
vue3 全平台新增通过 props 来获取页面参数的使用方式代码如下
script setup// 页面可以通过定义 props 来直接接收 url 传入的参数// 如uni.navigateTo({ url: /pages/index/index?id10 })const props defineProps({id: String,});console.log(id props.id); // id10
/scriptscript// 页面可以通过定义 props 来直接接收 url 传入的参数// 如uni.navigateTo({ url: /pages/index/index?id10 })export default {props: {id: {type: String,},},setup(props) {console.log(id props.id); // id10},};
/script25、小程序和App端不支持插值方式定义国际化
因运行平台限制目前在小程序和 App 端不支持插值方式定义国际化,需要使用 Messages Functions 定义国际化信息
示例
const messages {en: {greeting: ({ named }) hello, ${named(name)}!}
}template{{$t(index, {num: 123})}}
/template26、总结
推荐去UniApp官方文档上看那里的文档是最新的技术是不断发展的相应的也会变化官方文档也会相应更新。最好是去Vue的官方看下Vue3因为UniApp的Vue3也是基于Vue3的看原汁原味才能了然于胸。
