src/window/MessageBox.js

   1 /**
   2  * @class Ext.window.MessageBox
   3  * @extends Ext.window.Window
   4
   5 Utility class for generating different styles of message boxes.  The singleton instance, `Ext.Msg` can also be used.
   6 Note that a MessageBox is asynchronous.  Unlike a regular JavaScript `alert` (which will halt
   7 browser execution), showing a MessageBox will not cause the code to stop.  For this reason, if you have code
   8 that should only run *after* some user feedback from the MessageBox, you must use a callback function
   9 (see the `function` parameter for {@link #show} for more details).
  10
  11 {@img Ext.window.MessageBox/messagebox1.png alert MessageBox}
  12 {@img Ext.window.MessageBox/messagebox2.png prompt MessageBox}
  13 {@img Ext.window.MessageBox/messagebox3.png show MessageBox}
  14 #Example usage:#
  15
  16     // Basic alert:
  17     Ext.Msg.alert('Status', 'Changes saved successfully.');
  18
  19     // Prompt for user data and process the result using a callback:
  20     Ext.Msg.prompt('Name', 'Please enter your name:', function(btn, text){
  21         if (btn == 'ok'){
  22             // process text value and close...
  23         }
  24     });
  25
  26     // Show a dialog using config options:
  27     Ext.Msg.show({
  28          title:'Save Changes?',
  29          msg: 'You are closing a tab that has unsaved changes. Would you like to save your changes?',
  30          buttons: Ext.Msg.YESNOCANCEL,
  31          fn: processResult,
  32          animateTarget: 'elId',
  33          icon: Ext.window.MessageBox.QUESTION
  34     });
  35
  36  * @markdown
  37  * @singleton
  38  * @xtype messagebox
  39  */
  40 Ext.define('Ext.window.MessageBox', {
  41     extend: 'Ext.window.Window',
  42
  43     requires: [
  44         'Ext.toolbar.Toolbar',
  45         'Ext.form.field.Text',
  46         'Ext.form.field.TextArea',
  47         'Ext.button.Button',
  48         'Ext.layout.container.Anchor',
  49         'Ext.layout.container.HBox',
  50         'Ext.ProgressBar'
  51     ],
  52
  53     alternateClassName: 'Ext.MessageBox',
  54
  55     alias: 'widget.messagebox',
  56
  57     /**
  58      * Button config that displays a single OK button
  59      * @type Number
  60      */
  61     OK : 1,
  62     /**
  63      * Button config that displays a single Yes button
  64      * @type Number
  65      */
  66     YES : 2,
  67     /**
  68      * Button config that displays a single No button
  69      * @type Number
  70      */
  71     NO : 4,
  72     /**
  73      * Button config that displays a single Cancel button
  74      * @type Number
  75      */
  76     CANCEL : 8,
  77     /**
  78      * Button config that displays OK and Cancel buttons
  79      * @type Number
  80      */
  81     OKCANCEL : 9,
  82     /**
  83      * Button config that displays Yes and No buttons
  84      * @type Number
  85      */
  86     YESNO : 6,
  87     /**
  88      * Button config that displays Yes, No and Cancel buttons
  89      * @type Number
  90      */
  91     YESNOCANCEL : 14,
  92     /**
  93      * The CSS class that provides the INFO icon image
  94      * @type String
  95      */
  96     INFO : 'ext-mb-info',
  97     /**
  98      * The CSS class that provides the WARNING icon image
  99      * @type String
 100      */
 101     WARNING : 'ext-mb-warning',
 102     /**
 103      * The CSS class that provides the QUESTION icon image
 104      * @type String
 105      */
 106     QUESTION : 'ext-mb-question',
 107     /**
 108      * The CSS class that provides the ERROR icon image
 109      * @type String
 110      */
 111     ERROR : 'ext-mb-error',
 112
 113     // hide it by offsets. Windows are hidden on render by default.
 114     hideMode: 'offsets',
 115     closeAction: 'hide',
 116     resizable: false,
 117     title: '&#160;',
 118
 119     width: 600,
 120     height: 500,
 121     minWidth: 250,
 122     maxWidth: 600,
 123     minHeight: 110,
 124     maxHeight: 500,
 125     constrain: true,
 126
 127     cls: Ext.baseCSSPrefix + 'message-box',
 128
 129     layout: {
 130         type: 'anchor'
 131     },
 132
 133     /**
 134      * The default height in pixels of the message box's multiline textarea if displayed (defaults to 75)
 135      * @type Number
 136      */
 137     defaultTextHeight : 75,
 138     /**
 139      * The minimum width in pixels of the message box if it is a progress-style dialog.  This is useful
 140      * for setting a different minimum width than text-only dialogs may need (defaults to 250).
 141      * @type Number
 142      */
 143     minProgressWidth : 250,
 144     /**
 145      * The minimum width in pixels of the message box if it is a prompt dialog.  This is useful
 146      * for setting a different minimum width than text-only dialogs may need (defaults to 250).
 147      * @type Number
 148      */
 149     minPromptWidth: 250,
 150     /**
 151      * An object containing the default button text strings that can be overriden for localized language support.
 152      * Supported properties are: ok, cancel, yes and no.  Generally you should include a locale-specific
 153      * resource file for handling language support across the framework.
 154      * Customize the default text like so: Ext.window.MessageBox.buttonText.yes = "oui"; //french
 155      * @type Object
 156      */
 157     buttonText: {
 158         ok: 'OK',
 159         yes: 'Yes',
 160         no: 'No',
 161         cancel: 'Cancel'
 162     },
 163
 164     buttonIds: [
 165         'ok', 'yes', 'no', 'cancel'
 166     ],
 167
 168     titleText: {
 169         confirm: 'Confirm',
 170         prompt: 'Prompt',
 171         wait: 'Loading...',
 172         alert: 'Attention'
 173     },
 174
 175     iconHeight: 35,
 176
 177     makeButton: function(btnIdx) {
 178         var btnId = this.buttonIds[btnIdx];
 179         return Ext.create('Ext.button.Button', {
 180             handler: this.btnCallback,
 181             itemId: btnId,
 182             scope: this,
 183             text: this.buttonText[btnId],
 184             minWidth: 75
 185         });
 186     },
 187
 188     btnCallback: function(btn) {
 189         var me = this,
 190             value,
 191             field;
 192
 193         if (me.cfg.prompt || me.cfg.multiline) {
 194             if (me.cfg.multiline) {
 195                 field = me.textArea;
 196             } else {
 197                 field = me.textField;
 198             }
 199             value = field.getValue();
 200             field.reset();
 201         }
 202
 203         // Important not to have focus remain in the hidden Window; Interferes with DnD.
 204         btn.blur();
 205         me.hide();
 206         me.userCallback(btn.itemId, value, me.cfg);
 207     },
 208
 209     hide: function() {
 210         var me = this;
 211         me.dd.endDrag();
 212         me.progressBar.reset();
 213         me.removeCls(me.cfg.cls);
 214         me.callParent();
 215     },
 216
 217     initComponent: function() {
 218         var me = this,
 219             i, button;
 220
 221         me.title = '&#160;';
 222
 223         me.topContainer = Ext.create('Ext.container.Container', {
 224             anchor: '100%',
 225             style: {
 226                 padding: '10px',
 227                 overflow: 'hidden'
 228             },
 229             items: [
 230                 me.iconComponent = Ext.create('Ext.Component', {
 231                     cls: 'ext-mb-icon',
 232                     width: 50,
 233                     height: me.iconHeight,
 234                     style: {
 235                         'float': 'left'
 236                     }
 237                 }),
 238                 me.promptContainer = Ext.create('Ext.container.Container', {
 239                     layout: {
 240                         type: 'anchor'
 241                     },
 242                     items: [
 243                         me.msg = Ext.create('Ext.Component', {
 244                             autoEl: { tag: 'span' },
 245                             cls: 'ext-mb-text'
 246                         }),
 247                         me.textField = Ext.create('Ext.form.field.Text', {
 248                             anchor: '100%',
 249                             enableKeyEvents: true,
 250                             listeners: {
 251                                 keydown: me.onPromptKey,
 252                                 scope: me
 253                             }
 254                         }),
 255                         me.textArea = Ext.create('Ext.form.field.TextArea', {
 256                             anchor: '100%',
 257                             height: 75
 258                         })
 259                     ]
 260                 })
 261             ]
 262         });
 263         me.progressBar = Ext.create('Ext.ProgressBar', {
 264             anchor: '-10',
 265             style: 'margin-left:10px'
 266         });
 267
 268         me.items = [me.topContainer, me.progressBar];
 269
 270         // Create the buttons based upon passed bitwise config
 271         me.msgButtons = [];
 272         for (i = 0; i < 4; i++) {
 273             button = me.makeButton(i);
 274             me.msgButtons[button.itemId] = button;
 275             me.msgButtons.push(button);
 276         }
 277         me.bottomTb = Ext.create('Ext.toolbar.Toolbar', {
 278             ui: 'footer',
 279             dock: 'bottom',
 280             layout: {
 281                 pack: 'center'
 282             },
 283             items: [
 284                 me.msgButtons[0],
 285                 me.msgButtons[1],
 286                 me.msgButtons[2],
 287                 me.msgButtons[3]
 288             ]
 289         });
 290         me.dockedItems = [me.bottomTb];
 291
 292         me.callParent();
 293     },
 294
 295     onPromptKey: function(textField, e) {
 296         var me = this,
 297             blur;
 298
 299         if (e.keyCode === Ext.EventObject.RETURN || e.keyCode === 10) {
 300             if (me.msgButtons.ok.isVisible()) {
 301                 blur = true;
 302                 me.msgButtons.ok.handler.call(me, me.msgButtons.ok);
 303             } else if (me.msgButtons.yes.isVisible()) {
 304                 me.msgButtons.yes.handler.call(me, me.msgButtons.yes);
 305                 blur = true;
 306             }
 307
 308             if (blur) {
 309                 me.textField.blur();
 310             }
 311         }
 312     },
 313
 314     reconfigure: function(cfg) {
 315         var me = this,
 316             buttons = cfg.buttons || 0,
 317             hideToolbar = true,
 318             initialWidth = me.maxWidth,
 319             i;
 320
 321         cfg = cfg || {};
 322         me.cfg = cfg;
 323         if (cfg.width) {
 324             initialWidth = cfg.width;
 325         }
 326
 327         // Default to allowing the Window to take focus.
 328         delete me.defaultFocus;
 329
 330         // clear any old animateTarget
 331         me.animateTarget = cfg.animateTarget || undefined;
 332
 333         // Defaults to modal
 334         me.modal = cfg.modal !== false;
 335
 336         // Show the title
 337         if (cfg.title) {
 338             me.setTitle(cfg.title||'&#160;');
 339         }
 340
 341         if (!me.rendered) {
 342             me.width = initialWidth;
 343             me.render(Ext.getBody());
 344         } else {
 345             me.hidden = false;
 346             me.setSize(initialWidth, me.maxHeight);
 347         }
 348         me.setPosition(-10000, -10000);
 349
 350         // Hide or show the close tool
 351         me.closable = cfg.closable && !cfg.wait;
 352         if (cfg.closable === false) {
 353             me.tools.close.hide();
 354         } else {
 355             me.tools.close.show();
 356         }
 357
 358         // Hide or show the header
 359         if (!cfg.title && !me.closable) {
 360             me.header.hide();
 361         } else {
 362             me.header.show();
 363         }
 364
 365         // Default to dynamic drag: drag the window, not a ghost
 366         me.liveDrag = !cfg.proxyDrag;
 367
 368         // wrap the user callback
 369         me.userCallback = Ext.Function.bind(cfg.callback ||cfg.fn || Ext.emptyFn, cfg.scope || Ext.global);
 370
 371         // Hide or show the icon Component
 372         me.setIcon(cfg.icon);
 373
 374         // Hide or show the message area
 375         if (cfg.msg) {
 376             me.msg.update(cfg.msg);
 377             me.msg.show();
 378         } else {
 379             me.msg.hide();
 380         }
 381
 382         // Hide or show the input field
 383         if (cfg.prompt || cfg.multiline) {
 384             me.multiline = cfg.multiline;
 385             if (cfg.multiline) {
 386                 me.textArea.setValue(cfg.value);
 387                 me.textArea.setHeight(cfg.defaultTextHeight || me.defaultTextHeight);
 388                 me.textArea.show();
 389                 me.textField.hide();
 390                 me.defaultFocus = me.textArea;
 391             } else {
 392                 me.textField.setValue(cfg.value);
 393                 me.textArea.hide();
 394                 me.textField.show();
 395                 me.defaultFocus = me.textField;
 396             }
 397         } else {
 398             me.textArea.hide();
 399             me.textField.hide();
 400         }
 401
 402         // Hide or show the progress bar
 403         if (cfg.progress || cfg.wait) {
 404             me.progressBar.show();
 405             me.updateProgress(0, cfg.progressText);
 406             if(cfg.wait === true){
 407                 me.progressBar.wait(cfg.waitConfig);
 408             }
 409         } else {
 410             me.progressBar.hide();
 411         }
 412
 413         // Hide or show buttons depending on flag value sent.
 414         for (i = 0; i < 4; i++) {
 415             if (buttons & Math.pow(2, i)) {
 416
 417                 // Default to focus on the first visible button if focus not already set
 418                 if (!me.defaultFocus) {
 419                     me.defaultFocus = me.msgButtons[i];
 420                 }
 421                 me.msgButtons[i].show();
 422                 hideToolbar = false;
 423             } else {
 424                 me.msgButtons[i].hide();
 425             }
 426         }
 427
 428         // Hide toolbar if no buttons to show
 429         if (hideToolbar) {
 430             me.bottomTb.hide();
 431         } else {
 432             me.bottomTb.show();
 433         }
 434         me.hidden = true;
 435     },
 436
 437     /**
 438      * Displays a new message box, or reinitializes an existing message box, based on the config options
 439      * passed in. All display functions (e.g. prompt, alert, etc.) on MessageBox call this function internally,
 440      * although those calls are basic shortcuts and do not support all of the config options allowed here.
 441      * @param {Object} config The following config options are supported: <ul>
 442      * <li><b>animateTarget</b> : String/Element<div class="sub-desc">An id or Element from which the message box should animate as it
 443      * opens and closes (defaults to undefined)</div></li>
 444      * <li><b>buttons</b> : Number<div class="sub-desc">A bitwise button specifier consisting of the sum of any of the following constants:<ul>
 445      * <li>Ext.window.MessageBox.OK</li>
 446      * <li>Ext.window.MessageBox.YES</li>
 447      * <li>Ext.window.MessageBox.NO</li>
 448      * <li>Ext.window.MessageBox.CANCEL</li>
 449      * </ul>Or false to not show any buttons (defaults to false)</div></li>
 450      * <li><b>closable</b> : Boolean<div class="sub-desc">False to hide the top-right close button (defaults to true). Note that
 451      * progress and wait dialogs will ignore this property and always hide the close button as they can only
 452      * be closed programmatically.</div></li>
 453      * <li><b>cls</b> : String<div class="sub-desc">A custom CSS class to apply to the message box's container element</div></li>
 454      * <li><b>defaultTextHeight</b> : Number<div class="sub-desc">The default height in pixels of the message box's multiline textarea
 455      * if displayed (defaults to 75)</div></li>
 456      * <li><b>fn</b> : Function<div class="sub-desc">A callback function which is called when the dialog is dismissed either
 457      * by clicking on the configured buttons, or on the dialog close button, or by pressing
 458      * the return button to enter input.
 459      * <p>Progress and wait dialogs will ignore this option since they do not respond to user
 460      * actions and can only be closed programmatically, so any required function should be called
 461      * by the same code after it closes the dialog. Parameters passed:<ul>
 462      * <li><b>buttonId</b> : String<div class="sub-desc">The ID of the button pressed, one of:<div class="sub-desc"><ul>
 463      * <li><tt>ok</tt></li>
 464      * <li><tt>yes</tt></li>
 465      * <li><tt>no</tt></li>
 466      * <li><tt>cancel</tt></li>
 467      * </ul></div></div></li>
 468      * <li><b>text</b> : String<div class="sub-desc">Value of the input field if either <tt><a href="#show-option-prompt" ext:member="show-option-prompt" ext:cls="Ext.window.MessageBox">prompt</a></tt>
 469      * or <tt><a href="#show-option-multiline" ext:member="show-option-multiline" ext:cls="Ext.window.MessageBox">multiline</a></tt> is true</div></li>
 470      * <li><b>opt</b> : Object<div class="sub-desc">The config object passed to show.</div></li>
 471      * </ul></p></div></li>
 472      * <li><b>scope</b> : Object<div class="sub-desc">The scope (<code>this</code> reference) in which the function will be executed.</div></li>
 473      * <li><b>icon</b> : String<div class="sub-desc">A CSS class that provides a background image to be used as the body icon for the
 474      * dialog (e.g. Ext.window.MessageBox.WARNING or 'custom-class') (defaults to '')</div></li>
 475      * <li><b>iconCls</b> : String<div class="sub-desc">The standard {@link Ext.window.Window#iconCls} to
 476      * add an optional header icon (defaults to '')</div></li>
 477      * <li><b>maxWidth</b> : Number<div class="sub-desc">The maximum width in pixels of the message box (defaults to 600)</div></li>
 478      * <li><b>minWidth</b> : Number<div class="sub-desc">The minimum width in pixels of the message box (defaults to 100)</div></li>
 479      * <li><b>modal</b> : Boolean<div class="sub-desc">False to allow user interaction with the page while the message box is
 480      * displayed (defaults to true)</div></li>
 481      * <li><b>msg</b> : String<div class="sub-desc">A string that will replace the existing message box body text (defaults to the
 482      * XHTML-compliant non-breaking space character '&amp;#160;')</div></li>
 483      * <li><a id="show-option-multiline"></a><b>multiline</b> : Boolean<div class="sub-desc">
 484      * True to prompt the user to enter multi-line text (defaults to false)</div></li>
 485      * <li><b>progress</b> : Boolean<div class="sub-desc">True to display a progress bar (defaults to false)</div></li>
 486      * <li><b>progressText</b> : String<div class="sub-desc">The text to display inside the progress bar if progress = true (defaults to '')</div></li>
 487      * <li><a id="show-option-prompt"></a><b>prompt</b> : Boolean<div class="sub-desc">True to prompt the user to enter single-line text (defaults to false)</div></li>
 488      * <li><b>proxyDrag</b> : Boolean<div class="sub-desc">True to display a lightweight proxy while dragging (defaults to false)</div></li>
 489      * <li><b>title</b> : String<div class="sub-desc">The title text</div></li>
 490      * <li><b>value</b> : String<div class="sub-desc">The string value to set into the active textbox element if displayed</div></li>
 491      * <li><b>wait</b> : Boolean<div class="sub-desc">True to display a progress bar (defaults to false)</div></li>
 492      * <li><b>waitConfig</b> : Object<div class="sub-desc">A {@link Ext.ProgressBar#waitConfig} object (applies only if wait = true)</div></li>
 493      * <li><b>width</b> : Number<div class="sub-desc">The width of the dialog in pixels</div></li>
 494      * </ul>
 495      * Example usage:
 496      * <pre><code>
 497 Ext.Msg.show({
 498 title: 'Address',
 499 msg: 'Please enter your address:',
 500 width: 300,
 501 buttons: Ext.window.MessageBox.OKCANCEL,
 502 multiline: true,
 503 fn: saveAddress,
 504 animateTarget: 'addAddressBtn',
 505 icon: Ext.window.MessageBox.INFO
 506 });
 507 </code></pre>
 508      * @return {Ext.window.MessageBox} this
 509      */
 510     show: function(cfg) {
 511         var me = this;
 512
 513         me.reconfigure(cfg);
 514         me.addCls(cfg.cls);
 515         if (cfg.animateTarget) {
 516             me.doAutoSize(false);
 517             me.callParent();
 518         } else {
 519             me.callParent();
 520             me.doAutoSize(true);
 521         }
 522         return me;
 523     },
 524
 525     afterShow: function(){
 526         if (this.animateTarget) {
 527             this.center();
 528         }
 529         this.callParent(arguments);
 530     },
 531
 532     doAutoSize: function(center) {
 533         var me = this,
 534             icon = me.iconComponent,
 535             iconHeight = me.iconHeight;
 536
 537         if (!Ext.isDefined(me.frameWidth)) {
 538             me.frameWidth = me.el.getWidth() - me.body.getWidth();
 539         }
 540
 541         // reset to the original dimensions
 542         icon.setHeight(iconHeight);
 543
 544         // Allow per-invocation override of minWidth
 545         me.minWidth = me.cfg.minWidth || Ext.getClass(this).prototype.minWidth;
 546
 547         // Set best possible size based upon allowing the text to wrap in the maximized Window, and
 548         // then constraining it to within the max with. Then adding up constituent element heights.
 549         me.topContainer.doLayout();
 550         if (Ext.isIE6 || Ext.isIEQuirks) {
 551             // In IE quirks, the initial full width of the prompt fields will prevent the container element
 552             // from collapsing once sized down, so temporarily force them to a small width. They'll get
 553             // layed out to their final width later when setting the final window size.
 554             me.textField.setCalculatedSize(9);
 555             me.textArea.setCalculatedSize(9);
 556         }
 557         var width = me.cfg.width || me.msg.getWidth() + icon.getWidth() + 25, /* topContainer's layout padding */
 558             height = (me.header.rendered ? me.header.getHeight() : 0) +
 559             Math.max(me.promptContainer.getHeight(), icon.getHeight()) +
 560             me.progressBar.getHeight() +
 561             (me.bottomTb.rendered ? me.bottomTb.getHeight() : 0) + 20 ;/* topContainer's layout padding */
 562
 563         // Update to the size of the content, this way the text won't wrap under the icon.
 564         icon.setHeight(Math.max(iconHeight, me.msg.getHeight()));
 565         me.setSize(width + me.frameWidth, height + me.frameWidth);
 566         if (center) {
 567             me.center();
 568         }
 569         return me;
 570     },
 571
 572     updateText: function(text) {
 573         this.msg.update(text);
 574         return this.doAutoSize(true);
 575     },
 576
 577     /**
 578      * Adds the specified icon to the dialog.  By default, the class 'ext-mb-icon' is applied for default
 579      * styling, and the class passed in is expected to supply the background image url. Pass in empty string ('')
 580      * to clear any existing icon. This method must be called before the MessageBox is shown.
 581      * The following built-in icon classes are supported, but you can also pass in a custom class name:
 582      * <pre>
 583 Ext.window.MessageBox.INFO
 584 Ext.window.MessageBox.WARNING
 585 Ext.window.MessageBox.QUESTION
 586 Ext.window.MessageBox.ERROR
 587      *</pre>
 588      * @param {String} icon A CSS classname specifying the icon's background image url, or empty string to clear the icon
 589      * @return {Ext.window.MessageBox} this
 590      */
 591     setIcon : function(icon) {
 592         var me = this;
 593         me.iconComponent.removeCls(me.iconCls);
 594         if (icon) {
 595             me.iconComponent.show();
 596             me.iconComponent.addCls(Ext.baseCSSPrefix + 'dlg-icon');
 597             me.iconComponent.addCls(me.iconCls = icon);
 598         } else {
 599             me.iconComponent.removeCls(Ext.baseCSSPrefix + 'dlg-icon');
 600             me.iconComponent.hide();
 601         }
 602         return me;
 603     },
 604
 605     /**
 606      * Updates a progress-style message box's text and progress bar. Only relevant on message boxes
 607      * initiated via {@link Ext.window.MessageBox#progress} or {@link Ext.window.MessageBox#wait},
 608      * or by calling {@link Ext.window.MessageBox#show} with progress: true.
 609      * @param {Number} value Any number between 0 and 1 (e.g., .5, defaults to 0)
 610      * @param {String} progressText The progress text to display inside the progress bar (defaults to '')
 611      * @param {String} msg The message box's body text is replaced with the specified string (defaults to undefined
 612      * so that any existing body text will not get overwritten by default unless a new value is passed in)
 613      * @return {Ext.window.MessageBox} this
 614      */
 615     updateProgress : function(value, progressText, msg){
 616         this.progressBar.updateProgress(value, progressText);
 617         if (msg){
 618             this.updateText(msg);
 619         }
 620         return this;
 621     },
 622
 623     onEsc: function() {
 624         if (this.closable !== false) {
 625             this.callParent(arguments);
 626         }
 627     },
 628
 629     /**
 630      * Displays a confirmation message box with Yes and No buttons (comparable to JavaScript's confirm).
 631      * If a callback function is passed it will be called after the user clicks either button,
 632      * and the id of the button that was clicked will be passed as the only parameter to the callback
 633      * (could also be the top-right close button).
 634      * @param {String} title The title bar text
 635      * @param {String} msg The message box body text
 636      * @param {Function} fn (optional) The callback function invoked after the message box is closed
 637      * @param {Object} scope (optional) The scope (<code>this</code> reference) in which the callback is executed. Defaults to the browser wnidow.
 638      * @return {Ext.window.MessageBox} this
 639      */
 640     confirm: function(cfg, msg, fn, scope) {
 641         if (Ext.isString(cfg)) {
 642             cfg = {
 643                 title: cfg,
 644                 icon: 'ext-mb-question',
 645                 msg: msg,
 646                 buttons: this.YESNO,
 647                 callback: fn,
 648                 scope: scope
 649             };
 650         }
 651         return this.show(cfg);
 652     },
 653
 654     /**
 655      * Displays a message box with OK and Cancel buttons prompting the user to enter some text (comparable to JavaScript's prompt).
 656      * The prompt can be a single-line or multi-line textbox.  If a callback function is passed it will be called after the user
 657      * clicks either button, and the id of the button that was clicked (could also be the top-right
 658      * close button) and the text that was entered will be passed as the two parameters to the callback.
 659      * @param {String} title The title bar text
 660      * @param {String} msg The message box body text
 661      * @param {Function} fn (optional) The callback function invoked after the message box is closed
 662      * @param {Object} scope (optional) The scope (<code>this</code> reference) in which the callback is executed. Defaults to the browser wnidow.
 663      * @param {Boolean/Number} multiline (optional) True to create a multiline textbox using the defaultTextHeight
 664      * property, or the height in pixels to create the textbox (defaults to false / single-line)
 665      * @param {String} value (optional) Default value of the text input element (defaults to '')
 666      * @return {Ext.window.MessageBox} this
 667      */
 668     prompt : function(cfg, msg, fn, scope, multiline, value){
 669         if (Ext.isString(cfg)) {
 670             cfg = {
 671                 prompt: true,
 672                 title: cfg,
 673                 minWidth: this.minPromptWidth,
 674                 msg: msg,
 675                 buttons: this.OKCANCEL,
 676                 callback: fn,
 677                 scope: scope,
 678                 multiline: multiline,
 679                 value: value
 680             };
 681         }
 682         return this.show(cfg);
 683     },
 684
 685     /**
 686      * Displays a message box with an infinitely auto-updating progress bar.  This can be used to block user
 687      * interaction while waiting for a long-running process to complete that does not have defined intervals.
 688      * You are responsible for closing the message box when the process is complete.
 689      * @param {String} msg The message box body text
 690      * @param {String} title (optional) The title bar text
 691      * @param {Object} config (optional) A {@link Ext.ProgressBar#waitConfig} object
 692      * @return {Ext.window.MessageBox} this
 693      */
 694     wait : function(cfg, title, config){
 695         if (Ext.isString(cfg)) {
 696             cfg = {
 697                 title : title,
 698                 msg : cfg,
 699                 closable: false,
 700                 wait: true,
 701                 modal: true,
 702                 minWidth: this.minProgressWidth,
 703                 waitConfig: config
 704             };
 705         }
 706         return this.show(cfg);
 707     },
 708
 709     /**
 710      * Displays a standard read-only message box with an OK button (comparable to the basic JavaScript alert prompt).
 711      * If a callback function is passed it will be called after the user clicks the button, and the
 712      * id of the button that was clicked will be passed as the only parameter to the callback
 713      * (could also be the top-right close button).
 714      * @param {String} title The title bar text
 715      * @param {String} msg The message box body text
 716      * @param {Function} fn (optional) The callback function invoked after the message box is closed
 717      * @param {Object} scope (optional) The scope (<code>this</code> reference) in which the callback is executed. Defaults to the browser wnidow.
 718      * @return {Ext.window.MessageBox} this
 719      */
 720     alert: function(cfg, msg, fn, scope) {
 721         if (Ext.isString(cfg)) {
 722             cfg = {
 723                 title : cfg,
 724                 msg : msg,
 725                 buttons: this.OK,
 726                 fn: fn,
 727                 scope : scope,
 728                 minWidth: this.minWidth
 729             };
 730         }
 731         return this.show(cfg);
 732     },
 733
 734     /**
 735      * Displays a message box with a progress bar.  This message box has no buttons and is not closeable by
 736      * the user.  You are responsible for updating the progress bar as needed via {@link Ext.window.MessageBox#updateProgress}
 737      * and closing the message box when the process is complete.
 738      * @param {String} title The title bar text
 739      * @param {String} msg The message box body text
 740      * @param {String} progressText (optional) The text to display inside the progress bar (defaults to '')
 741      * @return {Ext.window.MessageBox} this
 742      */
 743     progress : function(cfg, msg, progressText){
 744         if (Ext.isString(cfg)) {
 745             cfg = {
 746                 title: cfg,
 747                 msg: msg,
 748                 progressText: progressText
 749             };
 750         }
 751         return this.show(cfg);
 752     }
 753 }, function() {
 754     Ext.MessageBox = Ext.Msg = new this();
 755 });