| Defined In: | MessageBox.js |
| Class: | Ext.MessageBox |
| Extends: | Object |
用来生成不同样式的消息框的实用类。还可以使用它的别名 Ext.Msg。
需要注意的是 MessageBox 对象是异步的。不同于 JavaScript 中原生的 alert(它会暂停浏览器的执行),显示 MessageBox 不会中断代码的运行。
由于这个原因,如果你的代码需要在用户对 MessageBox 做出反馈之后执行,则必须用到回调函数(详情可见 #show 方法中的 function 参数)。
用法示例:
// 基本的通知:
Ext.Msg.alert('Status', 'Changes saved successfully.');
// 提示用户输入数据并使用回调方法进得处理:
Ext.Msg.prompt('Name', 'Please enter your name:', function(btn, text){
if (btn == 'ok'){
// process text value and close...
}
});
// 显示一个使用配置选项的对话框:
Ext.Msg.show({
title:'Save Changes?',
msg: 'Your are closing a tab that has unsaved changes. Would you like to save your changes?',
buttons: Ext.Msg.YESNOCANCEL,
fn: processResult,
animEl: 'elId',
icon: Ext.MessageBox.QUESTION
});
| 方法 | 定义者 | |
|---|---|---|
|
getDialog
(
)
: Ext.Window
返回 {@link Ext.Window} 对象的元素的引用
返回 {@link Ext.Window} 对象的元素的引用
参数项:
|
MessageBox | |
updateText
(
[String text]
)
: Ext.MessageBox
更新消息框中 body 元素的文本
更新消息框中 body 元素的文本
参数项:
|
MessageBox | |
updateProgress
(
Number value,
String progressText,
String msg
)
: Ext.MessageBox
更新带有进度条的消息框中的文本和进度条。
仅仅是由通过 Ext....
更新带有进度条的消息框中的文本和进度条。
仅仅是由通过 Ext.MessageBox#progress 方法或者是在调用 Ext.MessageBox#show 方法时使用参数 progress: true 显示的消息框中可用。
参数项:
|
MessageBox | |
|
isVisible
(
)
: Boolean
如果消息框当前可见则返回 true
如果消息框当前可见则返回 true
参数项:
|
MessageBox | |
|
hide
(
)
: Ext.MessageBox
如果消息框当前可见则将其隐藏
如果消息框当前可见则将其隐藏
参数项:
|
MessageBox | |
show
(
Object config
)
: Ext.MessageBox
基于给定的配置选项显示一个消息框,或者重新初始一个现存的消息框。
...
基于给定的配置选项显示一个消息框,或者重新初始一个现存的消息框。
MessageBox 对象的所有显示函数(例如:prompt、alert、等等)均为内部调用此函数,
虽然这些调用均为此方法的简单的快捷方式并且不提供所有的下列配置选项。
属性 类型 说明
---------------- --------------- -----------------------------------------------------------------------------
animEl String/Element 消息框显示和关闭时动画展现的目标元素,或它的 ID(默认为 undefined)
buttons Object/Boolean Button 配置对象(例如:Ext.MessageBox.OKCANCEL 或者 {ok:'Foo',
cancel:'Bar'}),或者 false 表示不显示任何按钮(默认为 false)
closable Boolean 值为 false 则隐藏右上角的关闭按钮(默认为 true)。注意由于 progress 和 wait 对话框只能
通过程序关闭,因此它们将忽略此参数并总是隐藏关闭按钮。
cls String 应用到消息框的元素中的自定义 CSS 类
defaultTextHeight Number 以像素为单位表示的默认消息框的文本域高度,如果有的话(默认为 75)
fn Function 当对话框关闭后执行的回调函数。参数包括按钮(被点击的按钮的名字,如果可用,如:"ok"),
文本(活动的文本框的值,如果可用)。Progress 和 wait 对话框将忽略此选项,因为它们不会回应使用者的动作,
并且只能在程序中被关闭,所以任何必须的函数都可以放在关闭对话框的代码中调用。
icon String 一个指定了背景图片地址的 CSS 类名用于对话框显示图标(例如:Ext.MessageBox.WARNING 或者 'custom-class',默认这 '')
maxWidth Number 以像素为单位表示的消息框的最大宽度(默认为 600)
minWidth Number 以像素为单位表示的消息框的最小宽度(默认为 100)
modal Boolean 值为 false 时允许用户在消息框在显示时交互(默认为 true)
msg String 使用指定的文本替换消息框中元素的 innerHTML (默认为XHTML兼容的非换行空格字符 ' ')
multiline Boolean 值为 true 时显示一个提示用户输入多行文本的对话框(默认为 false)
progress Boolean 值为 true 时显示一个进度条(默认为 false)
progressText String 当 progress = true 时进度条内显示的文本(默认为 '')
prompt Boolean 值为 true 时显示一个提示用户输入单行文本的对话框(默认为 false)
proxyDrag Boolean 值为 true 则在拖拽的时候显示一个轻量级的代理(默认为 false)
title String 标题文本
value String 设置到活动文本框中的文本
wait Boolean 值为 true 时显示一个进度条(默认为 false)
waitConfig Object Ext.ProgressBar#waitConfig 对象(仅在 wait = true 时可用)
width Number 以像素为单位表示的对话框的宽度
用法示例:
参数项:
|
MessageBox | |
setIcon
(
String icon
)
: Ext.MessageBox
添加指定的图标到对话框中。默认情况下,'ext-mb-icon' ...
添加指定的图标到对话框中。默认情况下,'ext-mb-icon' 被应用于默认的样式,给定的样式类需要指定背景图片地址。
如果要清除图标则给定一个空字串('')。下面是提供的内建图标样式类,当然你也可以给定一个自定义的类:
Ext.MessageBox.INFO Ext.MessageBox.WARNING Ext.MessageBox.QUESTION Ext.MessageBox.ERROR
参数项:
|
MessageBox | |
progress
(
String title,
String msg,
String progressText
)
: Ext.MessageBox
显示一个带有进度条的消息框。此消息框没有按钮并且无法被用户关闭。
...
显示一个带有进度条的消息框。此消息框没有按钮并且无法被用户关闭。
你必须通过 Ext.MessageBox#updateProgress 方法更新进度条,并当进度完成时关闭消息框。
参数项:
|
MessageBox | |
wait
(
String msg,
[String title],
[Object config]
)
: Ext.MessageBox
显示一个带有不断自动更新的进度条的消息框。这个可以被用在一个长时间...
显示一个带有不断自动更新的进度条的消息框。这个可以被用在一个长时间运行的进程中防止用户交互。你需要在进程完成的时候关闭消息框。
参数项:
|
MessageBox | |
alert
(
String title,
String msg,
[Function fn],
[Object scope]
)
: Ext.MessageBox
显示一个标准的带有确认按钮的只读消息框(类似于 JavaScrip...
显示一个标准的带有确认按钮的只读消息框(类似于 JavaScript 原生的 alert、prompt)。
如果给定了回调函数,则会在用户点击按钮后执行,并且被点击的按钮的 ID 会当做唯一的参数传入到回调函数中(也有可能是右上角的关闭按钮)。
参数项:
|
MessageBox | |
confirm
(
String title,
String msg,
[Function fn],
[Object scope]
)
: Ext.MessageBox
显示一个带有是和否按钮的确认消息框(等同与 JavaScript ...
显示一个带有是和否按钮的确认消息框(等同与 JavaScript 原生的 confirm)。
如果给定了回调函数,则会在用户点击按钮后执行,并且被点击的按钮的 ID 会当做唯一的参数传入到回调函数中(也有可能是右上角的关闭按钮)。
参数项:
|
MessageBox | |
prompt
(
String title,
String msg,
[Function fn],
[Object scope],
[Boolean/Number multiline]
)
: Ext.MessageBox
显示一个带有确认和取消按钮的提示框,并接受用户输入文本(等同与 J...
显示一个带有确认和取消按钮的提示框,并接受用户输入文本(等同与 JavaScript 原生的 prompt)。
提示框可以是一个单行或多行文本框。如果给定了回调函数,则在用户点击任意一个按钮后执行回调函数,
并且被点击的按钮的 ID(有可能是右上角的关闭按钮)和用户输入的文本都将被当做参数传给回调函数。
值指定行数的文本域,或者一个以像素为单位表示的高度(默认为 false,表示单行)
参数项:
|
MessageBox | |
|
Msg
(
)
Ext.MessageBox 的缩写
Ext.MessageBox 的缩写
参数项:
|
MessageBox | |