Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
程序yang
unidocs-zh
提交
9e6cb0c3
U
unidocs-zh
项目概览
程序yang
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
1
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
9e6cb0c3
编写于
5月 16, 2022
作者:
study夏羽
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs:新增小程序跳转半屏模式
上级
23e88d5d
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
68 addition
and
0 deletion
+68
-0
docs/api/other/open-miniprogram.md
docs/api/other/open-miniprogram.md
+68
-0
未找到文件。
docs/api/other/open-miniprogram.md
浏览文件 @
9e6cb0c3
...
...
@@ -58,6 +58,7 @@ uni.navigateToMiniProgram({
|success|function|否|接口调用成功的回调函数|
|fail|function|否|接口调用失败的回调函数|
|complete|function|否|接口调用结束的回调函数(调用成功、失败都会执行)|
**示例代码**
```
js
uni
.
navigateBackMiniProgram
({
...
...
@@ -69,3 +70,70 @@ uni.navigateBackMiniProgram({
}
})
```
### uni.openEmbeddedMiniProgram(OBJECT)
微信小程序跳转小程序
**(半屏模式)**
(从微信础库 2.20.1 开始支持)
当小程序需要打开另一个小程序让用户进行快捷操作时,可将要打开的小程序以半屏的形态跳转。

**调用流程**
1.
微信小程序2.23.1以下版本基础库,开发者需要在全局配置
`manifest.json`
-->
`mp-weixin`
节点下添加
`embeddedAppIdList`
字段并声明需要半屏跳转的小程序,若不配置将切换为普通的小程序跳转小程序。2.23.1及以上版本起无需配置。
配置示例:
```
js
{
"
mp-weixin
"
:
{
"
embeddedAppIdList
"
:
[
"
wxe5f52902cf4de896
"
]
//需要半屏跳转的小程序appid
}
}
```
2.
开发者通过调用uni.openEmbeddedMiniProgram半屏跳转小程序:
|属性 |类型 |默认值|必填 |说明|
|-- |-- |-- |-- |-- |
|appId|string | | 是|要打开的小程序 appId|
|path |string | |否 | 打开的页面路径,如果为空则打开首页。path 中 ? 后面的部分会成为 query,在小程序的
``App.vue ``
的
`onLaunch`
、
`onShow`
和 Page.onLoad 的回调函数中可以获取到 query 数据。对于小游戏,可以只传入 query 部分,来实现传参效果,如:传入 "?foo=bar"。
[
详见
](
https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html
)
|
|extraData | object| |否 |需要传递给目标小程序的数据,目标小程序可在
``App.vue ``
的
`onLaunch`
或
`onShow`
中获取到这份数据。
[
详见
](
https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html
)
|
|envVersion|string |release |否 |要打开的小程序版本,有效值: develop(开发版),trial(体验版),release(正式版)。仅在当前小程序为开发版或体验版时此参数有效。如果当前小程序是正式版,则打开的小程序必定是正式版。 |
|shortLink |string | |否 |小程序链接,当传递该参数后,可以不传 appId 和 path。链接可以通过【小程序菜单】->【复制链接】获取。 |
|success |function | |否 |接口调用成功的回调函数 |
|fail|function | |否 |接口调用失败的回调函数 |
|complete |function | |否 |接口调用结束的回调函数(调用成功、失败都会执行)|
**示例代码**
```
js
uni
.
openEmbeddedMiniProgram
({
appId
:
''
,
path
:
'
pages/index/index?id=123
'
,
extraData
:
{
'
data1
'
:
'
test
'
},
success
(
res
)
{
// 打开成功
}
})
```
**使用限制**
2022年3月18日后,使用过程有以下限制,若不符合以下所有条件将被自动切换为普通的小程序跳转小程序,不影响用户使用:
1.
被半屏跳转的小程序需要通过来源小程序的调用申请,开发者可在 小程序管理后台「设置」-「第三方设置」-「半屏小程序管理」板块发起申请,最多可以申请10个小程序;
2.
微信小程序2.23.1版本以下基础库,被半屏打开的小程序需要在全局配置
`manifest.json`
-->
`mp-weixin`
节点下添加
`embeddedAppIdList`
字段并声明;
3.
当前小程序需为竖屏;
4.
被半屏跳转的小程序需为非个人主体小程序(不含小游戏)
2022年3月18日前,使用过程有以下限制,若不符合以下所有条件将被自动切换为普通的小程序跳转小程序,不影响用户使用:
1.
不能在横屏下打开半屏小程序
2.
能打开小游戏
3.
跳转目标小程序需符合以下类目,
[
详见小程序文档
](
https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html
)
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录