uni.showModal都有哪些属性
时间: 2025-06-15 09:56:14 浏览: 22
### `uni.showModal` 属性列表及使用方法
#### 1. 属性列表
以下是 `uni.showModal` 支持的主要属性及其作用[^2]:
| 属性名 | 类型 | 默认值 | 描述 |
|------------------|----------|----------|-----------------------------------------------------------------------------------------|
| `title` | String | "" | 设置弹窗的标题 |
| `content` | String | "" | 设置弹窗的内容,当启用输入框时 (`editable=true`),该字段会变为默认输入内容 |
| `showCancel` | Boolean | true | 是否显示取消按钮 |
| `cancelText` | String | "取消" | 取消按钮的文字 |
| `confirmText` | String | "确定" | 确定按钮的文字 |
| `cancelColor` | String | "#000000"| 取消按钮的颜色 |
| `confirmColor` | String | "#3CC51F" | 确认按钮的颜色 |
| `editable` | Boolean | false | 是否显示输入框,设置为 `true` 后会在弹窗中增加一个可编辑区域 |
| `placeholderText` | String | "" | 当 `editable=true` 时,设置输入框占位符 |
#### 2. 使用方法
以下是一个完整的示例代码,展示了如何使用 `uni.showModal` 创建带输入框的模态框,并在特定条件下阻止弹窗关闭的功能:
```javascript
// 调用 uni.showModal 方法
uni.showModal({
title: '请输入信息',
content: '', // 初始内容为空
editable: true, // 显示输入框
placeholderText: '请输入内容...', // 输入框提示语
confirmText: '提交', // 确认按钮文字
cancelText: '取消', // 取消按钮文字
success(res) {
if (res.confirm) { // 用户点击了确认按钮
const inputContent = res.content.trim(); // 获取用户输入并去除首尾空格
if (!inputContent) { // 如果输入为空
uni.showToast({ // 提示用户输入不能为空
title: '输入不能为空!',
icon: 'none'
});
return; // 阻止弹窗关闭
}
console.log('用户输入:', inputContent); // 输出用户输入内容
} else if (res.cancel) { // 用户点击了取消按钮
console.log('用户取消了操作');
}
},
fail(err) {
console.error('调用失败:', err); // 处理错误情况
}
});
```
#### 3. 特殊条件下的行为控制
- **阻止弹窗关闭**
在 `success` 回调函数中,如果检测到不符合预期的条件(如输入为空),可以直接返回而不执行其他逻辑。这样可以达到阻止弹窗关闭的效果[^2]。
- **自定义按钮文字和颜色**
通过设置 `confirmText` 和 `cancelText` 来更改按钮文字,使用 `confirmColor` 和 `cancelColor` 修改按钮颜色[^4]。
---
###
阅读全文
相关推荐


















