Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
良好的行为成为习惯
uni-app
提交
49cffa55
U
uni-app
项目概览
良好的行为成为习惯
/
uni-app
与 Fork 源项目一致
Fork自
DCloud / uni-app
通知
1
Star
1
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
1
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
uni-app
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
1
Issue
1
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
49cffa55
编写于
6月 24, 2021
作者:
F
fasttian
提交者:
Gitee
6月 24, 2021
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update docs/api/ui/prompt.md.
上级
2a9c32cc
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
201 addition
and
200 deletion
+201
-200
docs/api/ui/prompt.md
docs/api/ui/prompt.md
+201
-200
未找到文件。
docs/api/ui/prompt.md
浏览文件 @
49cffa55
### uni.showToast(OBJECT)
显示消息提示框。
**OBJECT参数说明**
|参数|类型|必填|说明|平台差异说明|
|:-|:-|:-|:-|:-|:-|
|title|String|是|提示的内容,长度与 icon 取值有关。||
|icon|String|否|图标,有效值详见下方说明。||
|image|String|否|自定义图标的本地路径(app端暂不支持gif)|App、H5、微信小程序、百度小程序|
|mask|Boolean|否|是否显示透明蒙层,防止触摸穿透,默认:false|App、微信小程序|
|duration|Number|否|提示的延迟时间,单位毫秒,默认:1500||
|position|String|否|纯文本轻提示显示位置,填写有效值后只有
`title`
属性生效, 有效值详见下方说明。|App|
|success|Function|否|接口调用成功的回调函数||
|fail|Function|否|接口调用失败的回调函数||
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)|
|
**icon 值说明**
|值|说明|平台差异说明|
|:-|:-|:-|
|success|显示成功图标,此时 title 文本最多显示 7 个汉字长度。默认值||
|loading|显示加载图标,此时 title 文本最多显示 7 个汉字长度。|支付宝小程序不支持|
|none|不显示图标,此时 title 文本在
`小程序`
最多可显示两行,
`App`
仅支持单行显示。|
|
**示例**
```
javascript
uni
.
showToast
({
title
:
'
标题
'
,
duration
:
2000
});
```
**position 值说明(仅App生效)**
|值|说明|
|:-|:-|
|top|居上显示|
|center|居中显示|
|bottom|居底显示|
**Tips**
-
App端可通过
[
plus.nativeUI.toast API
](
https://www.html5plus.org/doc/zh_cn/nativeui.html#plus.nativeUI.toast
)
实现更多功能。
### uni.hideToast()
隐藏消息提示框。
**示例**
```
javascript
uni
.
hideToast
();
```
### uni.showLoading(OBJECT)
显示 loading 提示框, 需主动调用
[
uni.hideLoading
](
api/ui/prompt?id=hideloading
)
才能关闭提示框。
**OBJECT参数说明**
|参数|类型|必填|说明|平台差异说明|
|:-|:-|:-|:-|:-|
|title|String|是|提示的文字内容,显示在loading的下方||
|mask|Boolean|否|是否显示透明蒙层,防止触摸穿透,默认:false|App、微信小程序、百度小程序|
|success|Function|否|接口调用成功的回调函数||
|fail|Function|否|接口调用失败的回调函数||
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)|
|
**示例**
```
javascript
uni
.
showLoading
({
title
:
'
加载中
'
});
```
### uni.hideLoading()
隐藏 loading 提示框。
**示例**
```
javascript
uni
.
showLoading
({
title
:
'
加载中
'
});
setTimeout
(
function
()
{
uni
.
hideLoading
();
},
2000
);
```
### uni.showModal(OBJECT)
显示模态弹窗,可以只有一个确定按钮,也可以同时有确定和取消按钮。类似于一个API整合了 html 中:alert、confirm。
**OBJECT参数说明**
|参数|类型|必填|说明|平台差异说明|
|:-|:-|:-|:-|:-|
|title|String|否|提示的标题||
|content|String|否|提示的内容||
|showCancel|Boolean|否|是否显示取消按钮,默认为 true||
|cancelText|String|否|取消按钮的文字,默认为"取消",最多 4 个字符||
|cancelColor|HexColor|否|取消按钮的文字颜色,默认为"#000000"|H5、微信小程序、百度小程序|
|confirmText|String|否|确定按钮的文字,默认为"确定",最多 4 个字符||
|confirmColor|HexColor|否|确定按钮的文字颜色,H5平台默认为"#007aff",微信小程序平台默认为"#3CC51F",百度小程序平台默认为"#3c76ff"|H5、微信小程序、百度小程序|
|success|Function|否|接口调用成功的回调函数||
|fail|Function|否|接口调用失败的回调函数||
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)|
|
**success返回参数说明**
|参数|类型|说明|
|:-|:-|:-|:-|
|confirm|Boolean|为 true 时,表示用户点击了确定按钮|
|cancel|Boolean|为 true 时,表示用户点击了取消(用于 Android 系统区分点击蒙层关闭还是点击取消按钮关闭)|
**示例**
```
javascript
uni
.
showModal
({
title
:
'
提示
'
,
content
:
'
这是一个模态弹窗
'
,
success
:
function
(
res
)
{
if
(
res
.
confirm
)
{
console
.
log
(
'
用户点击确定
'
);
}
else
if
(
res
.
cancel
)
{
console
.
log
(
'
用户点击取消
'
);
}
}
});
```
**注意**
-
弹框同时使用确定取消时,需注意不同平台的确认取消按钮位置不同。在微信、H5中,确认按钮默认在右边。在App中,iOS的确认按钮默认在右边,而Android默认在左边。产生这种差异的原因是uni.showModa在App和小程序上调用的是原生提供的弹出框,原生平台的策略本身就不同。如果需要调整,可以通过自行控制按钮的文字,即“确定”按钮的文字其实可以设置为“取消”。
-
showModal不满足需求时,可以自行开发组件弹框。插件市场有很多自定义弹框的组件,需注意在非H5平台,前端组件无法覆盖原生组件(如地图、video),遮罩也无法盖住tabbar和navigationbar。如需覆盖原生组件或遮罩tabbar等,App端推荐使用
[
subNvue
](
https://uniapp.dcloud.net.cn/api/window/subNVues
)
。
-
App端还有原生的
[
prompt API
](
https://www.html5plus.org/doc/zh_cn/nativeui.html#plus.nativeUI.prompt
)
,弹出界面中内置一个输入框。其他平台需自行封装前端组件实现。
-
钉钉小程序真机与模拟器表现有差异,真机title,content均为必填项
### uni.showActionSheet(OBJECT)
从底部向上弹出操作菜单
**OBJECT参数说明**
|参数|类型|必填|说明|平台差异说明|
|:-|:-|:-|:-|:-|
|itemList|Array
<
String
>
|是|按钮的文字数组|微信、百度、字节跳动小程序数组长度最大为6个|
|itemColor|HexColor|否|按钮的文字颜色,字符串格式,默认为"#000000"|App-iOS、字节跳动小程序不支持|
|popover|Object|否|大屏设备弹出原生选择按钮框的指示区域,默认居中显示|App-iPad(2.6.6+)、H5(2.9.2)|
|success|Function|否|接口调用成功的回调函数,详见返回参数说明||
|fail|Function|否|接口调用失败的回调函数||
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)|
|
**popover 值说明(仅App生效)**
|值|类型|说明|
|:-|:-|:-|
|top|Number|指示区域坐标,使用原生 navigationBar 时一般需要加上 navigationBar 的高度|
|left|Number|指示区域坐标|
|width|Number|指示区域宽度|
|height|Number|指示区域高度|
**success返回参数说明**
|参数|类型|说明|
|:-|:-|:-|
|tapIndex|Number|用户点击的按钮,从上到下的顺序,从0开始|
**示例**
```
javascript
uni
.
showActionSheet
({
itemList
:
[
'
A
'
,
'
B
'
,
'
C
'
],
success
:
function
(
res
)
{
console
.
log
(
'
选中了第
'
+
(
res
.
tapIndex
+
1
)
+
'
个按钮
'
);
},
fail
:
function
(
res
)
{
console
.
log
(
res
.
errMsg
);
}
});
```
**Tips**
-
App平台,iPad设备支持设置弹出框的位置,详见
[
plus.nativeUI的文档
](
https://www.html5plus.org/doc/zh_cn/nativeui.html#plus.nativeUI.ActionSheetStyles
)
-
App平台,实现原生的、复杂的底部图文菜单,例如分享菜单,可参考
[
https://ext.dcloud.net.cn/plugin?id=69
](
https://ext.dcloud.net.cn/plugin?id=69
)
**注意**
-
在非H5端,本章的所有弹出控件都是原生控件,层级最高,可覆盖video、map、tabbar等原生控件。
-
[
uni-app插件市场
](
https://ext.dcloud.net.cn/
)
有很多封装好的前端组件,但注意前端组件层级不是最高,无法覆盖原生组件,除非使用cover-view或nvue。
### uni.showToast(OBJECT)
显示消息提示框。
**OBJECT参数说明**
|参数|类型|必填|说明|平台差异说明|
|:-|:-|:-|:-|:-|:-|
|title|String|是|提示的内容,长度与 icon 取值有关。||
|icon|String|否|图标,有效值详见下方说明。||
|image|String|否|自定义图标的本地路径(app端暂不支持gif)|App、H5、微信小程序、百度小程序|
|mask|Boolean|否|是否显示透明蒙层,防止触摸穿透,默认:false|App、微信小程序|
|duration|Number|否|提示的延迟时间,单位毫秒,默认:1500||
|position|String|否|纯文本轻提示显示位置,填写有效值后只有
`title`
属性生效, 有效值详见下方说明。|App|
|success|Function|否|接口调用成功的回调函数||
|fail|Function|否|接口调用失败的回调函数||
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)|
|
**icon 值说明**
|值|说明|平台差异说明|
|:-|:-|:-|
|success|显示成功图标,此时 title 文本最多显示 7 个汉字长度。默认值||
|loading|显示加载图标,此时 title 文本最多显示 7 个汉字长度。|支付宝小程序不支持|
|none|不显示图标,此时 title 文本在
`小程序`
最多可显示两行,
`App`
仅支持单行显示。|
|
**示例**
```
javascript
uni
.
showToast
({
title
:
'
标题
'
,
duration
:
2000
});
```
**position 值说明(仅App生效)**
|值|说明|
|:-|:-|
|top|居上显示|
|center|居中显示|
|bottom|居底显示|
**Tips**
-
App端可通过
[
plus.nativeUI.toast API
](
https://www.html5plus.org/doc/zh_cn/nativeui.html#plus.nativeUI.toast
)
实现更多功能。
### uni.hideToast()
隐藏消息提示框。
**示例**
```
javascript
uni
.
hideToast
();
```
### uni.showLoading(OBJECT)
显示 loading 提示框, 需主动调用
[
uni.hideLoading
](
api/ui/prompt?id=hideloading
)
才能关闭提示框。
**OBJECT参数说明**
|参数|类型|必填|说明|平台差异说明|
|:-|:-|:-|:-|:-|
|title|String|是|提示的文字内容,显示在loading的下方||
|mask|Boolean|否|是否显示透明蒙层,防止触摸穿透,默认:false|App、微信小程序、百度小程序|
|success|Function|否|接口调用成功的回调函数||
|fail|Function|否|接口调用失败的回调函数||
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)|
|
**示例**
```
javascript
uni
.
showLoading
({
title
:
'
加载中
'
});
```
### uni.hideLoading()
隐藏 loading 提示框。
**示例**
```
javascript
uni
.
showLoading
({
title
:
'
加载中
'
});
setTimeout
(
function
()
{
uni
.
hideLoading
();
},
2000
);
```
### uni.showModal(OBJECT)
显示模态弹窗,可以只有一个确定按钮,也可以同时有确定和取消按钮。类似于一个API整合了 html 中:alert、confirm。
**OBJECT参数说明**
|参数|类型|必填|说明|平台差异说明|
|:-|:-|:-|:-|:-|
|title|String|否|提示的标题||
|content|String|否|提示的内容||
|showCancel|Boolean|否|是否显示取消按钮,默认为 true||
|cancelText|String|否|取消按钮的文字,默认为"取消",最多 4 个字符||
|cancelColor|HexColor|否|取消按钮的文字颜色,默认为"#000000"|H5、微信小程序、百度小程序|
|confirmText|String|否|确定按钮的文字,默认为"确定",最多 4 个字符||
|confirmColor|HexColor|否|确定按钮的文字颜色,H5平台默认为"#007aff",微信小程序平台默认为"#3CC51F",百度小程序平台默认为"#3c76ff"|H5、微信小程序、百度小程序|
|success|Function|否|接口调用成功的回调函数||
|fail|Function|否|接口调用失败的回调函数||
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)|
|
**success返回参数说明**
|参数|类型|说明|
|:-|:-|:-|:-|
|confirm|Boolean|为 true 时,表示用户点击了确定按钮|
|cancel|Boolean|为 true 时,表示用户点击了取消(用于 Android 系统区分点击蒙层关闭还是点击取消按钮关闭)|
**示例**
```
javascript
uni
.
showModal
({
title
:
'
提示
'
,
content
:
'
这是一个模态弹窗
'
,
success
:
function
(
res
)
{
if
(
res
.
confirm
)
{
console
.
log
(
'
用户点击确定
'
);
}
else
if
(
res
.
cancel
)
{
console
.
log
(
'
用户点击取消
'
);
}
}
});
```
**注意**
-
弹框同时使用确定取消时,需注意不同平台的确认取消按钮位置不同。在微信、H5中,确认按钮默认在右边。在App中,iOS的确认按钮默认在右边,而Android默认在左边。产生这种差异的原因是uni.showModa在App和小程序上调用的是原生提供的弹出框,原生平台的策略本身就不同。如果需要调整,可以通过自行控制按钮的文字,即“确定”按钮的文字其实可以设置为“取消”。
-
showModal不满足需求时,可以自行开发组件弹框。插件市场有很多自定义弹框的组件,需注意在非H5平台,前端组件无法覆盖原生组件(如地图、video),遮罩也无法盖住tabbar和navigationbar。如需覆盖原生组件或遮罩tabbar等,App端推荐使用
[
subNvue
](
https://uniapp.dcloud.net.cn/api/window/subNVues
)
。
-
App端还有原生的
[
prompt API
](
https://www.html5plus.org/doc/zh_cn/nativeui.html#plus.nativeUI.prompt
)
,弹出界面中内置一个输入框。其他平台需自行封装前端组件实现。
-
钉钉小程序真机与模拟器表现有差异,真机title,content均为必填项
### uni.showActionSheet(OBJECT)
从底部向上弹出操作菜单
**OBJECT参数说明**
|参数|类型|必填|说明|平台差异说明|
|:-|:-|:-|:-|:-|
|itemList|Array
<
String
>
|是|按钮的文字数组|微信、百度、字节跳动小程序数组长度最大为6个|
|alertText|String|否|选择按钮框的标题||
|itemColor|HexColor|否|按钮的文字颜色,字符串格式,默认为"#000000"|App-iOS、字节跳动小程序不支持|
|popover|Object|否|大屏设备弹出原生选择按钮框的指示区域,默认居中显示|App-iPad(2.6.6+)、H5(2.9.2)|
|success|Function|否|接口调用成功的回调函数,详见返回参数说明||
|fail|Function|否|接口调用失败的回调函数||
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)|
|
**popover 值说明(仅App生效)**
|值|类型|说明|
|:-|:-|:-|
|top|Number|指示区域坐标,使用原生 navigationBar 时一般需要加上 navigationBar 的高度|
|left|Number|指示区域坐标|
|width|Number|指示区域宽度|
|height|Number|指示区域高度|
**success返回参数说明**
|参数|类型|说明|
|:-|:-|:-|
|tapIndex|Number|用户点击的按钮,从上到下的顺序,从0开始|
**示例**
```
javascript
uni
.
showActionSheet
({
itemList
:
[
'
A
'
,
'
B
'
,
'
C
'
],
success
:
function
(
res
)
{
console
.
log
(
'
选中了第
'
+
(
res
.
tapIndex
+
1
)
+
'
个按钮
'
);
},
fail
:
function
(
res
)
{
console
.
log
(
res
.
errMsg
);
}
});
```
**Tips**
-
App平台,iPad设备支持设置弹出框的位置,详见
[
plus.nativeUI的文档
](
https://www.html5plus.org/doc/zh_cn/nativeui.html#plus.nativeUI.ActionSheetStyles
)
-
App平台,实现原生的、复杂的底部图文菜单,例如分享菜单,可参考
[
https://ext.dcloud.net.cn/plugin?id=69
](
https://ext.dcloud.net.cn/plugin?id=69
)
**注意**
-
在非H5端,本章的所有弹出控件都是原生控件,层级最高,可覆盖video、map、tabbar等原生控件。
-
[
uni-app插件市场
](
https://ext.dcloud.net.cn/
)
有很多封装好的前端组件,但注意前端组件层级不是最高,无法覆盖原生组件,除非使用cover-view或nvue。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录