模拟系统的消息提示框而实现的一套模态对话框组件,用于消息提示、确认消息和提交内容。
alert
、confirm
和 prompt
,因此适合展示较为简单的内容。如果需要弹出较为复杂的内容,请使用 Dialog。消息提示
当用户进行操作时会被触发,该对话框中断用户操作,直到用户确认知晓后才可关闭。
调用$alert
方法即可打开消息提示,它模拟了系统的 alert
,无法通过按下 ESC 或点击框外关闭。此例中接收了两个参数,message
和title
。值得一提的是,窗口被关闭后,它默认会返回一个Promise
对象便于进行后续操作的处理。若不确定浏览器是否支持Promise
,可自行引入第三方 polyfill 或像本例一样使用回调进行后续处理。
1 <template> 2 <el-button type="text" @click="open">点击打开 Message Box</el-button> 3 </template> 4 5 <script> 6 export default { 7 methods: { 8 open() { 9 this.$alert('这是一段内容', '标题名称', { 10 confirmButtonText: '确定', 11 callback: action => { 12 this.$message({ 13 type: 'info', 14 message: `action: ${ action }` 15 }); 16 } 17 }); 18 } 19 } 20 } 21 </script>
确认消息
提示用户确认其已经触发的动作,并询问是否进行此操作时会用到此对话框。
调用$confirm
方法即可打开消息提示,它模拟了系统的 confirm
。Message Box 组件也拥有极高的定制性,我们可以传入options
作为第三个参数,它是一个字面量对象。type
字段表明消息类型,可以为success
,error
,info
和warning
,无效的设置将会被忽略。注意,第二个参数title
必须定义为String
类型,如果是Object
,会被理解为options
。在这里我们用了 Promise 来处理后续响应。
1 <template> 2 <el-button type="text" @click="open2">点击打开 Message Box</el-button> 3 </template> 4 5 <script> 6 export default { 7 methods: { 8 open2() { 9 this.$confirm('此操作将永久删除该文件, 是否继续?', '提示', { 10 confirmButtonText: '确定', 11 cancelButtonText: '取消', 12 type: 'warning' 13 }).then(() => { 14 this.$message({ 15 type: 'success', 16 message: '删除成功!' 17 }); 18 }).catch(() => { 19 this.$message({ 20 type: 'info', 21 message: '已取消删除' 22 }); 23 }); 24 } 25 } 26 } 27 </script>
提交内容
当用户进行操作时会被触发,中断用户操作,提示用户进行输入的对话框。
调用$prompt
方法即可打开消息提示,它模拟了系统的 prompt
。可以用inputPattern
字段自己规定匹配模式,或者用inputValidator
规定校验函数,可以返回Boolean
或String
,返回false
或字符串时均表示校验未通过,同时返回的字符串相当于定义了inputErrorMessage
字段。此外,可以用inputPlaceholder
字段来定义输入框的占位符。
1 <template> 2 <el-button type="text" @click="open3">点击打开 Message Box</el-button> 3 </template> 4 5 <script> 6 export default { 7 methods: { 8 open3() { 9 this.$prompt('请输入邮箱', '提示', { 10 confirmButtonText: '确定', 11 cancelButtonText: '取消', 12 inputPattern: /[\w!#$%&'*+/=?^_`{|}~-]+(?:\.[\w!#$%&'*+/=?^_`{|}~-]+)*@(?:[\w](?:[\w-]*[\w])?\.)+[\w](?:[\w-]*[\w])?/, 13 inputErrorMessage: '邮箱格式不正确' 14 }).then(({ value }) => { 15 this.$message({ 16 type: 'success', 17 message: '你的邮箱是: ' + value 18 }); 19 }).catch(() => { 20 this.$message({ 21 type: 'info', 22 message: '取消输入' 23 }); 24 }); 25 } 26 } 27 } 28 </script>
自定义
可自定义配置不同内容。
以上三个方法都是对$msgbox
方法的再包装。本例直接调用$msgbox
方法,使用了showCancelButton
字段,用于显示取消按钮。另外可使用cancelButtonClass
为其添加自定义样式,使用cancelButtonText
来自定义按钮文本(Confirm 按钮也具有相同的字段,在文末的字段说明中有完整的字段列表)。此例还使用了beforeClose
属性,它的值是一个方法,会在 MessageBox 的实例关闭前被调用,同时暂停实例的关闭。它有三个参数:action
、实例本身和done
方法。使用它能够在关闭前对实例进行一些操作,比如为确定按钮添加loading
状态等;此时若需要关闭实例,可以调用done
方法(若在beforeClose
中没有调用done
,则实例不会关闭)。
1 <template> 2 <el-button type="text" @click="open4">点击打开 Message Box</el-button> 3 </template> 4 5 <script> 6 export default { 7 methods: { 8 open4() { 9 const h = this.$createElement; 10 this.$msgbox({ 11 title: '消息', 12 message: h('p', null, [ 13 h('span', null, '内容可以是 '), 14 h('i', { style: 'color: teal' }, 'VNode') 15 ]), 16 showCancelButton: true, 17 confirmButtonText: '确定', 18 cancelButtonText: '取消', 19 beforeClose: (action, instance, done) => { 20 if (action === 'confirm') { 21 instance.confirmButtonLoading = true; 22 instance.confirmButtonText = '执行中...'; 23 setTimeout(() => { 24 done(); 25 setTimeout(() => { 26 instance.confirmButtonLoading = false; 27 }, 300); 28 }, 3000); 29 } else { 30 done(); 31 } 32 } 33 }).then(action => { 34 this.$message({ 35 type: 'info', 36 message: 'action: ' + action 37 }); 38 }); 39 } 40 } 41 } 42 </script>
使用 HTML 片段
message
属性支持传入 HTML 片段
将dangerouslyUseHTMLString
属性设置为 true,message
就会被当作 HTML 片段处理。
1 <template> 2 <el-button type="text" @click="open5">点击打开 Message Box</el-button> 3 </template> 4 5 <script> 6 export default { 7 methods: { 8 open5() { 9 this.$alert('<strong>这是 <i>HTML</i> 片段</strong>', 'HTML 片段', { 10 dangerouslyUseHTMLString: true 11 }); 12 } 13 } 14 } 15 </script>
message
属性虽然支持传入 HTML 片段,但是在网站上动态渲染任意 HTML 是非常危险的,因为容易导致 XSS 攻击。因此在 dangerouslyUseHTMLString
打开的情况下,请确保 message
的内容是可信的,永远不要将用户提交的内容赋值给 message
属性。
居中布局
内容支持居中布局
将 center
设置为 true
即可开启居中布局
1 <template> 2 <el-button type="text" @click="open6">点击打开 Message Box</el-button> 3 </template> 4 5 <script> 6 export default { 7 methods: { 8 open6() { 9 this.$confirm('此操作将永久删除该文件, 是否继续?', '提示', { 10 confirmButtonText: '确定', 11 cancelButtonText: '取消', 12 type: 'warning', 13 center: true 14 }).then(() => { 15 this.$message({ 16 type: 'success', 17 message: '删除成功!' 18 }); 19 }).catch(() => { 20 this.$message({ 21 type: 'info', 22 message: '已取消删除' 23 }); 24 }); 25 } 26 } 27 } 28 </script>
全局方法
如果你完整引入了 Element,它会为 Vue.prototype 添加如下全局方法:$msgbox, $alert, $confirm 和 $prompt。因此在 Vue instance 中可以采用本页面中的方式调用 MessageBox
。调用参数为:
$msgbox(options)
$alert(message, title, options)
或$alert(message, options)
$confirm(message, title, options)
或$confirm(message, options)
$prompt(message, title, options)
或$prompt(message, options)
单独引用
如果单独引入 MessageBox
:
import { MessageBox } from 'element-ui';
那么对应于上述四个全局方法的调用方法依次为:MessageBox, MessageBox.alert, MessageBox.confirm 和 MessageBox.prompt,调用参数与全局方法相同。
Options
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
title | MessageBox 标题 | string | — | — |
message | MessageBox 消息正文内容 | string / VNode | — | — |
dangerouslyUseHTMLString | 是否将 message 属性作为 HTML 片段处理 | boolean | — | false |
type | 消息类型,用于显示图标 | string | success / info / warning / error | — |
customClass | MessageBox 的自定义类名 | string | — | — |
callback | 若不使用 Promise,可以使用此参数指定 MessageBox 关闭后的回调 | function(action, instance),action 的值为'confirm'或'cancel', instance 为 MessageBox 实例,可以通过它访问实例上的属性和方法 | — | — |
showClose | MessageBox 是否显示右上角关闭按钮 | boolean | — | true |
beforeClose | MessageBox 关闭前的回调,会暂停实例的关闭 | function(action, instance, done),action 的值为'confirm'或'cancel';instance 为 MessageBox 实例,可以通过它访问实例上的属性和方法;done 用于关闭 MessageBox 实例 | — | — |
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 | — | true(以 alert 方式调用时为 false) |
closeOnHashChange | 是否在 hashchange 时关闭 MessageBox | boolean | — | true |
showInput | 是否显示输入框 | boolean | — | false(以 prompt 方式调用时为 true) |
inputPlaceholder | 输入框的占位符 | string | — | — |
inputType | 输入框的类型 | string | — | text |
inputValue | 输入框的初始文本 | string | — | — |
inputPattern | 输入框的校验表达式 | regexp | — | — |
inputValidator | 输入框的校验函数。可以返回布尔值或字符串,若返回一个字符串, 则返回结果会被赋值给 inputErrorMessage | function | — | — |
inputErrorMessage | 校验未通过时的提示文本 | string | — | 输入的数据不合法! |
center | 是否居中布局 | boolean | — | false |
roundButton | 是否使用圆角按钮 | boolean | — | false |