show (
Object config
) : Ext.MessageBox
根據傳遞進來的配置選項, 顯示一個新的消息框,或者重新初始化一個已有的消息框...
根據傳遞進來的配置選項, 顯示一個新的消息框,或者重新初始化一個已有的消息框。 MessageBox上的所有顯示函數(例如prompt, alert等等)在內部調用此函數, 雖然這些調用是基本的快捷方式且並不支持這裏所允許的所有配置選項。
參數:
config
: Object
The following config options are supported:
- animEl : String/Element
一個id或者元素,作爲當打開和關閉消息框時動畫效果的起點(終點) (默認值爲 undefined)
- buttons : Object/Boolean
一個按鈕配置對象 (例如: Ext.MessageBox.OKCANCEL 或者 {ok:'Foo', cancel:'Bar'}),或者爲false,不允許任何按鈕 (默認值爲 false)
- closable : Boolean
設置爲false,禁用右上角的關閉按鈕(默認值爲 true)。注意:進展條和等待對話框將忽略此屬性,並且總是隱藏關閉按鈕,因爲它們只能通過程序關閉。
- cls : String
一個應用到消息框容器元素的定製CSS類
- defaultTextHeight : Number
T如果顯示,此值爲消息框多行文本默認高度的像素值(默認值爲 75)
- fn : Function
一個回調函數,在解散對話框時調用:通過點擊所配置的按鈕,或者對話框的關閉按鈕,或者通過按下返回按鈕鍵入輸入。
進展條和等待對話框將忽略此選項,因爲它們不會對用戶操作作出響應,並且只能通過程序關閉,所以在關閉對話框之後,任何所需的函數都應該在相同的代碼中被調用。 參數 passed:
- buttonId : String
- text : String
- opt : Object
配置對象。
- scope : Object
回調方法的作用域
- icon : String
一個CSS類,提供一個背景圖片,被用作對話框body的圖標 (例如Ext.MessageBox.WARNING 或者'custom-class') (默認值爲 '')
- iconCls : String
- maxWidth : Number
消息框最大寬度像素值(默認值爲 600)
- minWidth : Number
消息框最小寬度像素值(默認值爲 100)
- modal : Boolean
設置爲false,在顯示消息框時允許用戶與頁面進行交互(默認值爲 true)
- msg : String
一個字符串,用來替換消息框現有的body文本 (默認值爲遵守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
字符串值,用來設置到活動的textbox元素,如果它被顯示
- wait : Boolean
設置爲true以顯示一個進展條 (默認值爲 false)
- waitConfig : Object
- width : Number
對話框寬度像素值
示例用法:
Ext.Msg.show({
title: 'Address',
msg: 'Please enter your address:',
width: 300,
buttons: Ext.MessageBox.OKCANCEL,
multiline: true,
fn: saveAddress,
animEl: 'addAddressBtn',
icon: Ext.MessageBox.INFO
});
返回值: