Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
194b910c
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3172
Star
105
Fork
804
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
93
列表
看板
标记
里程碑
合并请求
67
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
93
Issue
93
列表
看板
标记
里程碑
合并请求
67
合并请求
67
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
194b910c
编写于
3月 08, 2023
作者:
Q
qiang
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs: update Composition API
上级
d5dda936
变更
8
隐藏空白更改
内联
并排
Showing
8 changed file
with
48 addition
and
10 deletion
+48
-10
docs/collocation/App.md
docs/collocation/App.md
+1
-0
docs/tutorial/README.md
docs/tutorial/README.md
+1
-1
docs/tutorial/_sidebar.md
docs/tutorial/_sidebar.md
+1
-0
docs/tutorial/page.md
docs/tutorial/page.md
+1
-1
docs/tutorial/vue-basics.md
docs/tutorial/vue-basics.md
+2
-4
docs/tutorial/vue-composition-api.md
docs/tutorial/vue-composition-api.md
+2
-2
docs/tutorial/vue3-basics.md
docs/tutorial/vue3-basics.md
+2
-2
docs/tutorial/vue3-composition-api.md
docs/tutorial/vue3-composition-api.md
+38
-0
未找到文件。
docs/collocation/App.md
浏览文件 @
194b910c
...
...
@@ -39,6 +39,7 @@
**注意**
-
**应用生命周期仅可在`App.vue`中监听,在其它页面监听无效**
。
-
以组合式 API 使用时,在 Vue2 和 Vue3 中存在一定区别,请分别参考:
[
Vue2 组合式 API 使用文档
](
/tutorial/vue-composition-api.html
)
和
[
Vue2 组合式 API 使用文档
](
/tutorial/vue3-composition-api.html
)
。
-
应用启动参数,可以在API
`uni.getLaunchOptionsSync`
获取,
[
详见
](
https://uniapp.dcloud.net.cn/api/plugins/getLaunchOptionsSync.html#getlaunchoptionssync
)
-
onlaunch里进行页面跳转,如遇白屏报错,请参考
[
https://ask.dcloud.net.cn/article/35942
](
https://ask.dcloud.net.cn/article/35942
)
-
`App.vue`
不能写模板
...
...
docs/tutorial/README.md
浏览文件 @
194b910c
...
...
@@ -12,7 +12,7 @@ DCloud还提供了使用js编写服务器代码的uniCloud云引擎。所以只
-
页面文件遵循
[
Vue 单文件组件 (SFC) 规范
](
https://vue-loader.vuejs.org/zh/spec.html
)
,即每个页面是一个.vue文件
-
组件标签靠近小程序规范,详见
[
uni-app 组件规范
](
/component/
)
-
接口能力(JS API)靠近小程序规范,但需将前缀
`wx`
、
`my`
等替换为
`uni`
,详见
[
uni-app接口规范
](
/api/
)
-
数据绑定及事件处理同
`Vue.js`
规范,同时补充了
App及页面的生命周期
-
数据绑定及事件处理同
`Vue.js`
规范,同时补充了
[
应用生命周期
](
https://uniapp.dcloud.net.cn/collocation/App.html#applifecycle
)
及
[
页面的生命周期
](
https://uniapp.dcloud.net.cn/tutorial/page.html#lifecycle
)
-
如需兼容app-nvue平台,建议使用flex布局进行开发
uni-app分
`编译器`
和
`运行时(runtime)`
。uni-app能实现一套代码、多端运行,是通过这2部分配合完成的。
...
...
docs/tutorial/_sidebar.md
浏览文件 @
194b910c
...
...
@@ -20,6 +20,7 @@
*
[
基础
](
/tutorial/vue3-basics.md
)
*
[
组件
](
/tutorial/vue3-components.md
)
*
[
API
](
/tutorial/vue3-api.md
)
*
[
组合式 API
](
/tutorial/vue3-composition-api.md
)
*
[
vuex
](
/tutorial/vue3-vuex.md
)
*
[
pinia
](
/tutorial/vue3-pinia.md
)
*
[
vue2 升 3 指南
](
/tutorial/migration-to-vue3.md
)
...
...
docs/tutorial/page.md
浏览文件 @
194b910c
...
...
@@ -30,7 +30,7 @@ uni-app项目中,一个页面就是一个符合`Vue SFC规范`的`.vue`文件
## 页面生命周期 @lifecycle
``uni-app``
支持如下页面生命周期函数:
``uni-app``
页面除支持 Vue 组件生命周期外还支持下方页面生命周期函数,当以组合式 API 使用时,在 Vue2 和 Vue3 中存在一定区别,请分别参考:
[
Vue2 组合式 API 使用文档
](
/tutorial/vue-composition-api.html
)
和
[
Vue2 组合式 API 使用文档
](
/tutorial/vue3-composition-api.html
)
。
|函数名|说明|平台差异说明|最低版本|
|:-|:-|:-|:-|
...
...
docs/tutorial/vue-basics.md
浏览文件 @
194b910c
...
...
@@ -223,10 +223,8 @@ vue 是单页面应用,使页面局部刷新,不用每次跳转页面都要
相比Web平台, Vue.js 在
`uni-app`
中使用差异主要集中在两个方面:
-
新增:
`uni-app`
除了支持Vue实例的生命周期,还支持
[
应用生命周期
](
/collocation/frame/lifecycle?id=应用生命周期
)
以及
[
页面生命周期
](
/collocation/frame/lifecycle?id=页面生命周期
)
。
-
受限:相比web平台,在小程序和App端部分功能受限,
[
具体见
](
/vue-api
)
。
-
uni-app 完整支持 Vue 模板语法。
-
App端可以使用更多的vue特性,
[
详见
](
https://ask.dcloud.net.cn/article/36599
)
。
-
新增:
`uni-app`
除了支持 Vue 实例的组件生命周期,还拥有
[
应用生命周期
](
/collocation/App.html#applifecycle
)
及
[
页面的生命周期
](
/tutorial/page.html#lifecycle
)
。
-
受限:相比 Web 平台,在小程序和 App 端部分功能支持不完善,具体见
[
兼容性列表
](
/vue3-api
)
。
...
...
docs/tutorial/vue-composition-api.md
浏览文件 @
194b910c
## 组合式 API
## 组合式 API
(Composition API)
目前 uni-app(Vue2) 基于 Vue 2.6,组合式 API 由
[
@vue/composition-api
](
https://github.com/vuejs/composition-api
)
支持,script setup 由
[
unplugin-vue2-script-setup
](
https://github.com/antfu/unplugin-vue2-script-setup
)
支持。
...
...
@@ -55,7 +55,7 @@ unplugin-vue2-script-setup](https://github.com/antfu/unplugin-vue2-script-setup)
:::
2.
从 @vue/composition-api 包内导入并使用基础的组合式API,具体的兼容性仍需参考:
[
@vue/composition-api
](
https://github.com/vuejs/composition-api#browser-compatibility
)
。从 @dcloudio/uni-app 包内导入 uni-app
其他生命周期API
。
2.
从 @vue/composition-api 包内导入并使用基础的组合式API,具体的兼容性仍需参考:
[
@vue/composition-api
](
https://github.com/vuejs/composition-api#browser-compatibility
)
。从 @dcloudio/uni-app 包内导入 uni-app
[
应用生命周期
](
/collocation/App.html#applifecycle
)
及
[
页面的生命周期
](
/tutorial/page.html#lifecycle
)
。
```
js
import
{
defineComponent
,
ref
}
from
'
@vue/composition-api
'
...
...
docs/tutorial/vue3-basics.md
浏览文件 @
194b910c
...
...
@@ -279,8 +279,8 @@ vue 是单页面应用,使页面局部刷新,不用每次跳转页面都要
相比Web平台, Vue.js 在
`uni-app`
中使用差异主要集中在两个方面:
-
新增:
`uni-app`
除了支持
Vue实例的生命周期,还支持
[
应用生命周期
](
https://uniapp.dcloud.io/collocation/App#应用生命周期
)
以及
[
页面生命周期
](
https://uniapp.dcloud.io/tutorial/page
#lifecycle
)
。
-
受限:相比
web平台,在小程序和App端部分功能受限,
[
具体见
](
/vue3-api
)
。
-
新增:
`uni-app`
除了支持
Vue 实例的组件生命周期,还拥有
[
应用生命周期
](
/collocation/App.html#applifecycle
)
及
[
页面的生命周期
](
/tutorial/page.html
#lifecycle
)
。
-
受限:相比
Web 平台,在小程序和 App 端部分功能支持不完善,具体见
[
兼容性列表
](
/vue3-api
)
。
[
uni-app 项目支持 vue 3.0介绍,及升级指南
](
https://ask.dcloud.net.cn/article/37834
)
...
...
docs/tutorial/vue3-composition-api.md
0 → 100644
浏览文件 @
194b910c
## 组合式 API(Composition API)
通过组合式 API,我们可以使用导入的 API 函数来描述组件逻辑。在单文件组件中,组合式 API 通常会与
```<script setup>```
搭配使用。这个 setup attribute 是一个标识,告诉 Vue 需要在编译时进行一些处理,让我们可以更简洁地使用组合式 API。比如,
```<script setup>```
中的导入和顶层变量/函数都能够在模板中直接使用。
### 使用组合式API
从 vue 包内导入并使用基础的组合式API,具体 API 可以参考:
[
Vue 官网
](
https://cn.vuejs.org/api/composition-api-setup.html
)
。从 @dcloudio/uni-app 包内导入 uni-app
[
应用生命周期
](
/collocation/App.html#applifecycle
)
及
[
页面的生命周期
](
/tutorial/page.html#lifecycle
)
。
```
js
import
{
defineComponent
,
ref
}
from
'
vue
'
import
{
onReady
}
from
'
@dcloudio/uni-app
'
export
default
defineComponent
({
setup
()
{
const
title
=
ref
(
'
Hello
'
)
onReady
(()
=>
{
console
.
log
(
'
onReady
'
)
})
return
{
title
}
}
})
```
### 使用 Script Setup
改用 Script Setup 写法导入 API
```
vue
<
script
setup
>
import
{
ref
}
from
'
vue
'
import
{
onReady
}
from
'
@dcloudio/uni-app
'
const
title
=
ref
(
'
Hello
'
)
onReady
(()
=>
{
console
.
log
(
'
onReady
'
)
})
</
script
>
```
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录