dialog(对话框)

创建并显示对话框,弹出的对话框为非阻塞模式,用户点击对话框上的按钮后关闭( h5模式的对话框也可通过 closepopup关闭 ),并通过callback函数返回用户点击按钮的索引值或输入框中的值。

Dialog 组件包含:

组件名作用快速体验
alert警告框
confirm确认框
prompt输入对话框
toast消息提示框

mui会根据ua判断,弹出原生对话框还是h5绘制的对话框,在基座中默认会弹出原生对话框,可以配置type属性,使得弹出h5模式对话框

两者区别:1.原生对话框可以跨webview,2.h5对话框样式统一而且可以修改对话框属性或样式

mui v3.0 版本(含)以上的dialog控件支持换行(\n)显示

  • [

    .alert( message, title, btnValue, callback [, type] )

    ](#on-events-selector-data-handler)

    • message

      Type: String

      提示对话框上显示的内容

    • title

      Type: String

      提示对话框上显示的标题

    • btnValue

      Type: String

      提示对话框上按钮显示的内容

    • callback

      Type: Function

      提示对话框上关闭后的回调函数

    • type

      Value: ‘div’

      是否使用h5绘制的对话框

  • [

    .confirm( message, title, btnValue, callback [, type] )

    ](#on-events-selector-data-handler)

    • message

      Type: String

      提示对话框上显示的内容

    • title

      Type: String

      提示对话框上显示的标题

    • btnValue

      Type: Array

      提示对话框上按钮显示的内容

    • callback

      Type: Function

      提示对话框上关闭后的回调函数

    • type

      Value: ‘div’

      是否使用h5绘制的对话框

  • [

    .prompt( message, placeholder, title, btnValue, callback[, type] )

    ](#on-events-selector-data-handler)

    • message

      Type: String

      提示对话框上显示的内容

    • placeholder

      Type: String

      编辑框显示的提示文字

    • title

      Type: String

      提示对话框上显示的标题

    • btnValue

      Type: Array

      提示对话框上按钮显示的内容

    • callback

      Type: Function

      提示对话框上关闭后的回调函数

    • type

      Value: ‘div’

      是否使用h5绘制的对话框

如果有定制对话框样式的需求( 只能修改h5模式对话框;))可以在mui.css中修改.mui-popup类下的样式

如果需要修改DOM结构可以按照以下方式处理.

  1. //修改弹出框默认input类型为password
  2. mui.prompt('text','deftext','title',['true','false'],null,'div')
  3. document.querySelector('.mui-popup-input input').type='password'
  • [

    .toast( message [,options])

    ](#on-events-selector-data-handler)

    • message:'String' - 消息框显示的文字内容
  1. options: `{JSON} - 提示消息的参数`
  2. [\*\*options 参数需要mui v3.5+支持](https://dev.dcloud.net.cn/mui/ui/javascript:void(0);)
  3. <table><thead><tr><th>参数</th><th>说明</th><th>说明</th></tr></thead><tbody><tr><td>duration</td><td>持续显示时间,默认值 <code>short</code>(2000ms)</td><td>支持 <b>整数值</b> 和 <b>String</b> ,<br>String可选: <code>long</code>(3500ms),<code>short</code>(2000ms)</td></tr><tr><td>type</td><td>强制使用mui消息框(div模式)</td><td><code>'div'</code></td></tr></tbody></table>
  4. ```
  5. mui.toast('登陆成功',{ duration:'long', type:'div' })
  6. ```
  • [

    .closePopup()(只能关闭h5模式的对话框)

    ](#on-events-selector-data-handler)

    • 关闭最后一次弹出的对话框
  • [

    .closePopups()(只能关闭h5模式的对话框)

    ](#on-events-selector-data-handler)

    • 关闭所有对话框

扩展阅读

问答社区话题讨论:利用mui toast制作下拉刷新获取新内容的提示

代码块激活字符:

mdalert

mdconfirm

mdprompt

mdtoast

mdclosepopup

mdclosepopups