mirror of
https://gitee.com/ElemeFE/element.git
synced 2024-12-05 05:38:24 +08:00
261 lines
9.4 KiB
Markdown
261 lines
9.4 KiB
Markdown
<script>
|
||
export default {
|
||
methods: {
|
||
open() {
|
||
this.$alert('这是一段内容', '标题名称', {
|
||
confirmButtonText: '确定',
|
||
callback: action => {
|
||
this.$message({
|
||
type: 'info',
|
||
message: `action: ${ action }`
|
||
});
|
||
}
|
||
});
|
||
},
|
||
|
||
open2() {
|
||
this.$confirm('此操作将永久删除该文件, 是否继续?', '提示', {
|
||
confirmButtonText: '确定',
|
||
cancelButtonText: '取消',
|
||
type: 'warning'
|
||
}).then(() => {
|
||
setTimeout(() => {
|
||
this.$message({
|
||
message: '删除成功!',
|
||
type: 'success'
|
||
});
|
||
}, 200);
|
||
}).catch(() => {
|
||
setTimeout(() => {
|
||
this.$message({
|
||
message: '已取消删除',
|
||
type: 'info'
|
||
});
|
||
}, 200);
|
||
});
|
||
},
|
||
|
||
open3() {
|
||
this.$prompt('请输入邮箱', '提示', {
|
||
confirmButtonText: '确定',
|
||
cancelButtonText: '取消',
|
||
inputPattern: /[\w!#$%&'*+/=?^_`{|}~-]+(?:\.[\w!#$%&'*+/=?^_`{|}~-]+)*@(?:[\w](?:[\w-]*[\w])?\.)+[\w](?:[\w-]*[\w])?/,
|
||
inputErrorMessage: '邮箱格式不正确'
|
||
}).then(({ value }) => {
|
||
setTimeout(() => {
|
||
this.$message({
|
||
type: 'success',
|
||
message: '你的邮箱是: ' + value
|
||
});
|
||
}, 200);
|
||
}).catch(() => {
|
||
setTimeout(() => {
|
||
this.$message({
|
||
type: 'info',
|
||
message: '取消输入'
|
||
});
|
||
}, 200);
|
||
});
|
||
},
|
||
|
||
|
||
open4() {
|
||
this.$msgbox({
|
||
title: '消息',
|
||
message: '这是一段内容, 这是一段内容, 这是一段内容, 这是一段内容, 这是一段内容, 这是一段内容, 这是一段内容',
|
||
showCancelButton: true,
|
||
confirmButtonText: '确定',
|
||
cancelButtonText: '取消'
|
||
}).then(action => {
|
||
setTimeout(() => {
|
||
this.$message({
|
||
type: 'info',
|
||
message: 'action: ' + action
|
||
});
|
||
}, 200);
|
||
});
|
||
}
|
||
|
||
}
|
||
};
|
||
</script>
|
||
## MessageBox 弹框
|
||
模拟系统的消息提示框而实现的一套模态对话框组件，用于消息提示、成功提示、错误提示、询问信息。
|
||
|
||
### 消息提示
|
||
|
||
当用户进行操作时会被触发，该对话框中断用户操作，直到用户确认知晓后才可关闭。
|
||
|
||
:::demo 调用`$alert`方法即可打开消息提示，它模拟了系统的 `alert`，无法通过按下 ESC 或点击框外关闭。此例中接收了两个参数，`message`和`title`。值得一提的是，窗口被关闭后，它默认会返回一个`Promise`对象便于进行后续操作的处理。若不确定浏览器是否支持`Promise`，可自行引入第三方 polyfill 或像本例一样使用回调进行后续处理。
|
||
```html
|
||
<template>
|
||
<el-button type="text" @click="open">点击打开 Message Box</el-button>
|
||
</template>
|
||
|
||
<script>
|
||
export default {
|
||
methods: {
|
||
open() {
|
||
this.$alert('这是一段内容', '标题名称', {
|
||
confirmButtonText: '确定',
|
||
callback: action => {
|
||
this.$message({
|
||
type: 'info',
|
||
message: `action: ${ action }`
|
||
});
|
||
}
|
||
});
|
||
}
|
||
}
|
||
}
|
||
</script>
|
||
```
|
||
:::
|
||
|
||
### 确认消息
|
||
|
||
提示用户确认其已经触发的动作，并询问是否进行此操作时会用到此对话框。
|
||
|
||
:::demo 调用`$confirm`方法即可打开消息提示，它模拟了系统的 `confirm`。Message Box 组件也拥有极高的定制性，我们可以传入`options`作为第三个参数，它是一个字面量对象。`type`字段表明消息类型，可以为`success`，`error`，`info`和`warning`，无效的设置将会被忽略。注意，第二个参数`title`必须定义为`String`类型，如果是`Object`，会被理解为`options`。在这里我们用了 Promise 来处理后续响应。
|
||
|
||
```html
|
||
<template>
|
||
<el-button type="text" @click="open2">点击打开 Message Box</el-button>
|
||
</template>
|
||
|
||
<script>
|
||
export default {
|
||
methods: {
|
||
open2() {
|
||
this.$confirm('此操作将永久删除该文件, 是否继续?', '提示', {
|
||
confirmButtonText: '确定',
|
||
cancelButtonText: '取消',
|
||
type: 'warning'
|
||
}).then(() => {
|
||
this.$message({
|
||
type: 'success',
|
||
message: '删除成功!'
|
||
});
|
||
}).catch(() => {
|
||
this.$message({
|
||
type: 'info',
|
||
message: '已取消删除'
|
||
});
|
||
});
|
||
}
|
||
}
|
||
}
|
||
</script>
|
||
```
|
||
:::
|
||
|
||
### 提交内容
|
||
|
||
当用户进行操作时会被触发，中断用户操作，提示用户进行输入的对话框。
|
||
|
||
:::demo 调用`$prompt`方法即可打开消息提示，它模拟了系统的 `prompt`。可以用`inputPattern`字段自己规定匹配模式，或者用`inputValidator`规定校验函数，可以返回`Boolean`或`String`，`Boolean`为`false`或字符串时均表示校验未通过，`String`相当于定义了`inputErrorMessage`字段。此外，可以用`inputPlaceholder`字段来定义输入框的占位符。
|
||
|
||
```html
|
||
<template>
|
||
<el-button type="text" @click="open3">点击打开 Message Box</el-button>
|
||
</template>
|
||
|
||
<script>
|
||
export default {
|
||
methods: {
|
||
open3() {
|
||
this.$prompt('请输入邮箱', '提示', {
|
||
confirmButtonText: '确定',
|
||
cancelButtonText: '取消',
|
||
inputPattern: /[\w!#$%&'*+/=?^_`{|}~-]+(?:\.[\w!#$%&'*+/=?^_`{|}~-]+)*@(?:[\w](?:[\w-]*[\w])?\.)+[\w](?:[\w-]*[\w])?/,
|
||
inputErrorMessage: '邮箱格式不正确'
|
||
}).then(({ value }) => {
|
||
this.$message({
|
||
type: 'success',
|
||
message: '你的邮箱是: ' + value
|
||
});
|
||
}).catch(() => {
|
||
this.$message({
|
||
type: 'info',
|
||
message: '取消输入'
|
||
});
|
||
});
|
||
}
|
||
}
|
||
}
|
||
</script>
|
||
```
|
||
:::
|
||
|
||
### 自定义
|
||
|
||
可自定义配置不同内容。
|
||
|
||
:::demo 以上三个方法都是对`$msgbox`方法的再包装。本例直接调用`$msgbox`方法，使用了`showCancelButton`字段，用于显示取消按钮。另外可使用`cancelButtonClass`为其添加自定义样式，使用`cancelButtonText`来自定义按钮文本。Confirm 按钮也具有相同的字段，在文末的字段说明中有完整的字段列表。
|
||
|
||
```html
|
||
<template>
|
||
<el-button type="text" @click="open4">点击打开 Message Box</el-button>
|
||
</template>
|
||
|
||
<script>
|
||
export default {
|
||
methods: {
|
||
open4() {
|
||
this.$msgbox({
|
||
title: '消息',
|
||
message: '这是一段内容, 这是一段内容, 这是一段内容, 这是一段内容, 这是一段内容, 这是一段内容, 这是一段内容',
|
||
showCancelButton: true,
|
||
confirmButtonText: '确定',
|
||
cancelButtonText: '取消'
|
||
}).then(action => {
|
||
this.$message({
|
||
type: 'info',
|
||
message: 'action: ' + action
|
||
});
|
||
});
|
||
},
|
||
}
|
||
}
|
||
</script>
|
||
```
|
||
:::
|
||
|
||
### 全局方法
|
||
|
||
Element 为 Vue.prototype 添加了如下全局方法：$msgbox, $alert, $confirm 和 $prompt。因此在 vue instance 中可以采用本页面中的方式调用 `MessageBox`。
|
||
|
||
### 单独引用
|
||
|
||
单独引入 `MessageBox`：
|
||
|
||
```javascript
|
||
import { MessageBox } from 'element-ui';
|
||
```
|
||
|
||
对应于上述四个全局方法的调用方法依次为：MessageBox, MessageBox.alert, MessageBox.confirm 和 MessageBox.prompt。
|
||
|
||
### Options
|
||
|
||
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|
||
|---------- |-------------- |---------- |-------------------------------- |-------- |
|
||
| title | MessageBox 标题 | string | — | — |
|
||
| message | MessageBox 消息正文内容 | string | — | — |
|
||
| type | 消息类型，用于显示图标 | string | success/info/warning/error | — |
|
||
| customClass | MessageBox 的自定义类名 | string | — | — |
|
||
| callback | 若不使用 Promise，可以使用此参数指定 MessageBox 关闭后的回调 | function(action)，action 的值为'confirm'或'cancel' | — | — |
|
||
| lockScroll | 是否在 MessageBox 出现时将 body 滚动锁定 | boolean | — | true |
|
||
| showCancelButton | 是否显示取消按钮 | boolean | — | false（以 confirm 和 prompt 方式调用时为 true） |
|
||
| showConfirmButton | 是否显示确定按钮 | boolean | — | true |
|
||
| cancelButtonText | 取消按钮的文本内容 | string | — | 取消 |
|
||
| confirmButtonText | 确定按钮的文本内容 | string | — | 确定 |
|
||
| cancelButtonClass | 取消按钮的自定义类名 | string | — | — |
|
||
| confirmButtonClass | 确定按钮的自定义类名 | string | — | — |
|
||
| closeOnClickModal | 是否可通过点击遮罩关闭 MessageBox | boolean | — | true（以 alert 方式调用时为 false） |
|
||
| closeOnPressEscape | 是否可通过按下 ESC 键关闭 MessageBox | boolean | — | false |
|
||
| showInput | 是否显示输入框 | boolean | — | false（以 prompt 方式调用时为 true）|
|
||
| inputPlaceholder | 输入框的占位符 | string | — | — |
|
||
| inputPattern | 输入框的校验表达式 | regexp | — | — |
|
||
| inputValidator | 输入框的校验函数。可以返回布尔值或字符串，若返回一个字符串, 则返回结果会被赋值给 inputErrorMessage | function | — | — |
|
||
| inputErrorMessage | 校验未通过时的提示文本 | string | — | 输入的数据不合法! |
|