提交 43eb557b 编写于 作者: inkwalk's avatar inkwalk

update: vue2 and vue3 tabs

上级 5e2fc42b
此差异已折叠。
`main.js`uni-app的入口文件,主要作用是初始化`vue`实例、定义全局组件、使用需要的插件如vuex。 `main.js` uni-app 的入口文件,主要作用是初始化`vue`实例、定义全局组件、使用需要的插件如 vuex。
首先引入了`Vue`库和`App.vue`,创建了一个`vue`实例,并且挂载`vue`实例。 首先引入了`Vue`库和`App.vue`,创建了一个`vue`实例,并且挂载`vue`实例。
::: preview
> Vue2
```js ```js
import Vue from 'vue' import Vue from 'vue'
import App from './App' import App from './App'
import pageHead from './components/page-head.vue' //全局引用page-head组件 import pageHead from './components/page-head.vue' //全局引用 page-head 组件
Vue.config.productionTip = false Vue.config.productionTip = false
Vue.component('page-head', pageHead) //全局注册page-head组件,每个页面将可以直接使用该组件 Vue.component('page-head', pageHead) //全局注册 page-head 组件,每个页面将可以直接使用该组件
App.mpType = 'app' App.mpType = 'app'
const app = new Vue({ const app = new Vue({
...App ...App
}) })
app.$mount() //挂载Vue实例 app.$mount() //挂载 Vue 实例
```
> Vue3
```JS
import App from './App'
import { createSSRApp } from 'vue'
export function createApp() {
const app = createSSRApp(App)
return {
app
}
}
``` ```
:::
使用`Vue.use`引用插件,使用`Vue.prototype`添加全局变量,使用`Vue.component`注册全局组件。 使用`Vue.use`引用插件,使用`Vue.prototype`添加全局变量,使用`Vue.component`注册全局组件。
可以引用`vuex`,因涉及多个文件,此处没有提供示例,详见`hello uni-app`示例工程。 可以引用`vuex`,因涉及多个文件,此处没有提供示例,详见`hello uni-app`示例工程。
......
...@@ -6,6 +6,10 @@ ...@@ -6,6 +6,10 @@
- 创建应用实例 - 创建应用实例
::: preview
> Vue2
```JS ```JS
// 之前 - Vue 2 // 之前 - Vue 2
import Vue from 'vue' import Vue from 'vue'
...@@ -16,41 +20,46 @@ ...@@ -16,41 +20,46 @@
...App ...App
}) })
app.$mount() app.$mount()
```
// 之后 - Vue 3 > Vue3
```JS
import App from './App' import App from './App'
import { createSSRApp } from 'vue' import { createSSRApp } from 'vue'
export function createApp() { export function createApp() {
const app = createSSRApp(App) const app = createSSRApp(App)
return { return {
app app
} }
} }
``` ```
:::
- 全局属性,例如:全局网络请求 - 全局属性,例如:全局网络请求
```js ```js
// 之前 - Vue 2 // 之前 - Vue 2
Vue.prototype.$http = () => {}; Vue.prototype.$http = () => {};
// 之后 - Vue 3 // 之后 - Vue 3
const app = createApp({}); const app = createApp({});
app.config.globalProperties.$http = () => {}; app.config.globalProperties.$http = () => {};
``` ```
- 插件使用,例如:使用 vuex 的 store - 插件使用,例如:使用 vuex 的 store
```js ```js
// 之前 - Vue 2 // 之前 - Vue 2
import store from "./store"; import store from "./store";
Vue.prototype.$store = store; Vue.prototype.$store = store;
// 之后 - Vue 3 // 之后 - Vue 3
import store from "./store"; import store from "./store";
const app = createApp(App); const app = createApp(App);
app.use(store); app.use(store);
``` ```
- 项目根目录必需创建 index.html 文件,粘贴复制如下内容: - 项目根目录必需创建 index.html 文件,粘贴复制如下内容:
...@@ -92,14 +101,17 @@ ...@@ -92,14 +101,17 @@
// 之前 - Vue 2, 依赖如使用 commonJS 方式导出 // 之前 - Vue 2, 依赖如使用 commonJS 方式导出
module.exports.X = X; module.exports.X = X;
// 之后 - Vue 3, 可手动改为 ES6 导出 // 之后 - Vue 3, 只支持 ES6 模块
export default { X }; export default { X };
``` ```
- vuex 用法 - vuex 用法
::: preview
> Vue2
```js ```js
// 之前 - Vue 2
import Vue from 'vue' import Vue from 'vue'
import Vuex from 'vuex' import Vuex from 'vuex'
Vue.use(Vuex) Vue.use(Vuex)
...@@ -107,8 +119,11 @@ ...@@ -107,8 +119,11 @@
state: {} state: {}
}) })
export default store export default store
```
> Vue3
// 之后 - Vue 3 ```js
import { createStore } from 'vuex' import { createStore } from 'vuex'
const store = createStore({ const store = createStore({
state: {} state: {}
...@@ -116,6 +131,8 @@ ...@@ -116,6 +131,8 @@
export default store export default store
``` ```
:::
- 避免在同一元素上同时使用 v-if 与 v-for - 避免在同一元素上同时使用 v-if 与 v-for
> 而 Vue3 中,v-if 总是优先于 v-for 生效。以上写法将会在 Vue3 中与预期不符合,由于语法上存在歧义,建议避免在同一元素上同时使用两者([更多](https://v3.cn.vuejs.org/guide/migration/v-if-v-for.html#%E6%A6%82%E8%A7%88))。 > 而 Vue3 中,v-if 总是优先于 v-for 生效。以上写法将会在 Vue3 中与预期不符合,由于语法上存在歧义,建议避免在同一元素上同时使用两者([更多](https://v3.cn.vuejs.org/guide/migration/v-if-v-for.html#%E6%A6%82%E8%A7%88))。
...@@ -199,6 +216,10 @@ ...@@ -199,6 +216,10 @@
Vue3 将不支持 `slot="xxx"` 的用法 ,请使用 `v-slot:xxx` 用法。[更多](https://v3.cn.vuejs.org/guide/component-slots.html#%E5%85%B7%E5%90%8D%E6%8F%92%E6%A7%BD) Vue3 将不支持 `slot="xxx"` 的用法 ,请使用 `v-slot:xxx` 用法。[更多](https://v3.cn.vuejs.org/guide/component-slots.html#%E5%85%B7%E5%90%8D%E6%8F%92%E6%A7%BD)
::: preview
> Vue2
```html ```html
<!-- Vue2 支持的用法 --> <!-- Vue2 支持的用法 -->
<uni-nav-bar> <uni-nav-bar>
...@@ -207,6 +228,8 @@ ...@@ -207,6 +228,8 @@
</view> </view>
</uni-nav-bar> </uni-nav-bar>
``` ```
> Vue3
```html ```html
<!-- Vue3 支持的用法 --> <!-- Vue3 支持的用法 -->
...@@ -219,16 +242,21 @@ ...@@ -219,16 +242,21 @@
</uni-nav-bar> </uni-nav-bar>
``` ```
:::
- 从 Vue 3.0 开始,过滤器已删除,不再支持,建议用方法调用或计算属性替换它们。[更多](https://v3.cn.vuejs.org/guide/migration/filters.html#%E6%A6%82%E8%A7%88) - 从 Vue 3.0 开始,过滤器已删除,不再支持,建议用方法调用或计算属性替换它们。[更多](https://v3.cn.vuejs.org/guide/migration/filters.html#%E6%A6%82%E8%A7%88)
- 在 Vue3 中,处理 API `Promise 化` 调用结果的方式不同于 Vue2。[更多](https://uniapp.dcloud.io/api/#api-promise-化) - 在 Vue3 中,处理 API `Promise 化` 调用结果的方式不同于 Vue2。[更多](https://uniapp.dcloud.io/api/#api-promise-化)
- Vue3 中,调用成功会进入 then 方法,调用失败会进入 catch 方法 - Vue3 中,调用成功会进入 then 方法,调用失败会进入 catch 方法
- Vue2 中,调用无论成功还是失败,都会进入 then 方法,返回数据的第一个参数是错误对象,第二个参数是返回数据 - Vue2 中,调用无论成功还是失败,都会进入 then 方法,返回数据的第一个参数是错误对象,第二个参数是返回数据
- Vue 2 写法转 Vue 3 写法
::: preview
> Vue2
```js ```js
// 在 main.js 中写入以下代码即可 // Vue 2 转 Vue 3, 在 main.js 中写入以下代码即可
function isPromise(obj) { function isPromise(obj) {
return ( return (
!!obj && !!obj &&
...@@ -255,10 +283,10 @@ ...@@ -255,10 +283,10 @@
}); });
``` ```
- Vue 3 写法转 Vue 2 写法 > Vue3
```js ```js
// 在 main.js 中写入以下代码即可 // Vue 3 转 Vue 2, 在 main.js 中写入以下代码即可
function isPromise(obj) { function isPromise(obj) {
return ( return (
!!obj && !!obj &&
...@@ -284,72 +312,83 @@ ...@@ -284,72 +312,83 @@
}, },
}); });
``` ```
:::
- uni-app 生命周期钩子在 Vue3 组合式 API 中的使用方式如下: - uni-app 生命周期钩子在 Vue3 组合式 API 中的使用方式如下:
- 在 Vue3 组合式 API 中,也需要遵循 uni-app 生命周期钩子规范, 如 onLaunch 等应用生命周期仅可在 App.vue 中监听,使用中请注意生命周期钩子的适用范围。[查看全部生命周期钩子](https://uniapp.dcloud.net.cn/collocation/frame/lifecycle)
- 只能在 `<script setup>` 单文件语法糖或 `setup()` 方法中使用生命周期钩子,以 A 页面跳转 B 页面传递参数为例: - 在 Vue3 组合式 API 中,也需要遵循 uni-app 生命周期钩子规范, 如 onLaunch 等应用生命周期仅可在 App.vue 中监听,使用中请注意生命周期钩子的适用范围。[查看全部生命周期钩子](https://uniapp.dcloud.net.cn/collocation/frame/lifecycle)
- 只能在 `<script setup>` 单文件语法糖或 `setup()` 方法中使用生命周期钩子,以 A 页面跳转 B 页面传递参数为例:
```js ::: preview
// 从 A 页面跳转 B 页面时传递参数 ?id=1&name=uniapp,xxx 为跳转的页面路径
//uni.navigateTo({ > 方法一
// url: 'xxx?id=1&name=uniapp'
//}) ```js
// 从 A 页面跳转 B 页面时传递参数 ?id=1&name=uniapp,xxx 为跳转的页面路径
// 方式一:在 B 页面 <script setup> 中 //uni.navigateTo({
<script setup> // url: 'xxx?id=1&name=uniapp'
import { //})
onLoad,
onShow // 方法一:在 B 页面 <script setup> 中
} from "@dcloudio/uni-app"; <script setup>
import {
// onLoad 接受 A 页面传递的参数 onLoad,
onLoad((option) => { onShow
console.log("B 页面 onLoad:", option); //B 页面 onLoad: {id: '1', name: 'uniapp'} } from "@dcloudio/uni-app";
});
// onLoad 接受 A 页面传递的参数
onShow(() => { onLoad((option) => {
console.log("B 页面 onShow"); console.log("B 页面 onLoad:", option); //B 页面 onLoad: {id: '1', name: 'uniapp'}
}); });
</script>
``` onShow(() => {
console.log("B 页面 onShow");
```js });
// 方式二:在 B 页面 setup() 中 </script>
<script> ```
import {
onLoad, > 方法二
onShow,
} from "@dcloudio/uni-app"; ```js
// 方法二:在 B 页面 setup() 中
export default { <script>
setup() { import {
// onLoad 接受 A 页面传递的参数 onLoad,
onLoad((option) => { onShow,
console.log("B 页面 onLoad:", option); //B 页面 onLoad: {id: '1', name: 'uniapp'} } from "@dcloudio/uni-app";
});
export default {
onShow(() => { setup() {
console.log("B 页面 onShow"); // onLoad 接受 A 页面传递的参数
}); onLoad((option) => {
} console.log("B 页面 onLoad:", option); //B 页面 onLoad: {id: '1', name: 'uniapp'}
});
onShow(() => {
console.log("B 页面 onShow");
});
} }
</script> }
``` </script>
```
:::
- 在 Vue3 中,this 对象下的 `$mp` 调整为 `$scope` - 在 Vue3 中,this 对象下的 `$mp` 调整为 `$scope`
- 在 Vue3 中,如果 nvue 使用了 Vuex 的相关 API,需要在 main.js 的 createApp 的返回值中 return 一下 Vuex 示例: - 在 Vue3 中,如果 nvue 使用了 Vuex 的相关 API,需要在 main.js 的 createApp 的返回值中 return 一下 Vuex 示例:
```js ```js
export function createApp() { export function createApp() {
const app = createSSRApp(App) const app = createSSRApp(App);
app.use(store) app.use(store);
return { return {
app, app,
Vuex // 如果 nvue 使用 vuex 的各种map工具方法时,必须 return Vuex Vuex, // 如果 nvue 使用 vuex 的各种map工具方法时,必须 return Vuex
} };
} }
``` ```
- App,小程序端源码调试,需要在 vite.config.js 中主动开启 sourcemap - App,小程序端源码调试,需要在 vite.config.js 中主动开启 sourcemap
```js ```js
...@@ -369,7 +408,7 @@ ...@@ -369,7 +408,7 @@
}); });
``` ```
-vue3 的小程序平台中,监听原生的点击事件可以先使用tap。(在vue3中,移除了.native修饰符,所以编译器无法预知click是要触发原生事件,还是组件的自定义事件,故并未转换成小程序的tap事件) - vue3 的小程序平台中,监听原生的点击事件可以先使用 tap。(在 vue3 中,移除了.native 修饰符,所以编译器无法预知 click 是要触发原生事件,还是组件的自定义事件,故并未转换成小程序的 tap 事件)
- vue3 支持的手机版本最低到多少? - vue3 支持的手机版本最低到多少?
> vue3 支持的范围是:Android > 4.4, ios >= 10 > vue3 支持的范围是:Android > 4.4, ios >= 10
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册