ExtJS学习之路第四步:看源码,实战MessageBox

可以通过看MessageBox.js的源码来深入认识,记住它的主要用法。Ext.MessageBox是实用类,用于生成不同风格的消息框,它是Singleton(单例),别名Ext.Msg。注意MessageBox是异步的,不同于一般的Javascript'alert'(它将停止浏览器的执行),显示一个MessageBox不会导致代码停止。出于这个原因,如果你有代码应该只运行在MessageBox用户反馈之后,你就应该加一个回调函数。

 Ext.MessageBox.alert()

样式:警告框只有一个OK button 

定义:alert: function(cfg, msg, fn, scope) {}

@param {String}title -标题栏的文字[查看定义发现,如果cfg是string类型的话,就是title,否则处理为config配置]
@param {String} msg -消息框主题文字
@param {Function} [fn] -在消息框被关闭之后触发回调函数,可以是点击按钮关闭也可以点击X关闭。
@param {Object} [scope=window] scope (this的引用) 回调函数运行的环境

<button id="btAlert" type="button">Alert</button>
<p id="pCon">Before Click!</p>
Ext.onReady(function(){ 
    Ext.get("btAlert").on('click',function(){
    Ext.Msg.alert('Name', 'Yixiaoheng',function(){
        Ext.get("pCon").setHTML("After click!");
     });
    }); 
});

警告框

Ext.MessageBox.confirm()

样式:确认消息框,有两个按钮Yes 和No

定义:confirm: function(cfg, msg, fn, scope) {}

参数含义同上

Ext.onReady(function(){ 
   var pCon="";
    Ext.get("btMsg").on("click", function () {
      var pCon="没有点击按钮,关闭了提示框";
     Ext.get("btConfirm").on("click", function () {
         Ext.MessageBox.confirm("提示", "是否要跳转页面?", function (btnId) {
              pCon="点击了"+btnId+"按钮!";   //yes\no\cancel         
             Ext.fly("pCon").setHTML();
        });
    }); 
   });
});

Ext.MessageBox.prompt()

样式:显示一个带有OK、Cancel按钮的消息框,提示用户输入些文字。这个提示可以是单行或者是多行的textbox。

定义:prompt : function(cfg, msg, fn, scope, multiline, value){}

@param {Boolean/Number} [multiline=false] True是创建多行textbox,用默认的文本高度defaultTextHeight
@param {String} [value=''] 默认文本输入框的值

Ext.onReady(function(){ 
    Ext.get("btMsg").on("click", function () {
        Ext.MessageBox.prompt(
            "2014计划",
            "请简略概述",
            function (btn, text) {
                Ext.fly("pCon").setHTML("点击了" + btn + "按钮,输入内容:" + text);
            },
            this,
            true,       //multiline
            "亲,说点想法吧");
                           
        });
});

PS:foucus到文本框上去的时候,原值不会自动消失。

Ext.MessageBox.progress()

显示:带进度条的消息框

定义: progress : function(cfg, msg, progressText){}

@param {String} [progressText=''] 显示在进度条里面的文字。

需要自己负责更新进度条updateProgress,并且当进度条完毕的时候关闭消息框

Ext.get("btMsg").on("click", function () {     
        Ext.MessageBox.progress("进度", "正在处理,请稍候...", "0%");
});

但是这个是静态的哦,是不会动的啦!

Ext.MessageBox.updateProgress() 

更新进度样式上的文字和进度。
updateProgress : function(value, progressText, msg){

  this.progressBar.updateProgress(value, progressText);
  if (msg){
    this.updateText(msg);
  }
  return this;
},

@param {Number} [value=0] 0-1之间,比如0.6
@param {String} [progressText=''] 在进度条内部显示的文字
@param {String} [msg] 消息框主题的文字,默认没有定义

Ext.get("btMsg").on("click", function () {     
        Ext.MessageBox.progress("进度", "正在处理,请稍候...", "0%");
        updateProgress(0);
    });

 function updateProgress (progress) {
    if (progress >= 1) {//进度条到头了
        Ext.MessageBox.updateProgress(1, "处理完成!","处理完成");
        Ext.defer(function () { Ext.MessageBox.close(); }, 200);//类似setTimeout延迟200毫秒关闭消息框
        return;
    }
    Ext.MessageBox.updateProgress(progress,"已完成"+Math.round(progress * 100) + "%");
        Ext.defer(function () {
            updateProgress(progress + 0.1);
        }, 500);//递归
}
 

Ext.MessageBox.wait()

说明:显示无限自动更新进度条的消息框。这可以被用来阻止用户交互,而等待一个长期运行的进程来完成一个没有定义的时间间隔。当过程完成时,自己负责关闭消息框。

定义:

wait : function(cfg, title, config){
  if (Ext.isString(cfg)) {
    cfg = {
        title : title,
          msg : cfg,
        closable: false,

        wait: true,

        modal: true,
        minWidth: this.minProgressWidth,
        waitConfig: config//
    };
  }
  return this.show(cfg);
},

title-标题 cfg-主题内容 config-这个值被付给waitConfig最后,实质调用的是progressBar的wait()方法,参数具体可以查http://docs.sencha.com/extjs/4.2.1/#!/api/Ext.ProgressBar

Ext.get("btMsg").on("click", function () {     
        Ext.MessageBox.wait("详细信息内容", "标题", {
            interval: 100,//进度条加载速度
            duration: 10000,//持续时间  
            fn:function(){
                this.updateText('加载完毕');
            }
        });
        Ext.defer(function () {
            Ext.MessageBox.hide();
            }, 15000);
});

加载完毕之后中间进度条显示'加载完毕'。

一种是progress进度条,一种是wait如何取舍?

进度条对话框中显示的进度是需要我们控制的,也就是说,如果你知道一件事情的处理进度,并能够及时的更新进度条,那么建议使用进度条对话框。

如果说你要处理一个事情,但是不知道处理时间,这是我们就会用到等待对话框了,等待对话框中的进度条会一直循环,直到我们处理完成后将它关闭掉

其实,来自Ext.ProgressBar类,查看http://docs.sencha.com/extjs/4.2.1/source/ProgressBar.html#Ext-ProgressBar你就能在开头明白,ProgressBar有两类,一种是人工一种自动。在MessageBox中不过是继承自此罢了。

最后但很重要

你注意到没参数中的cfg?所有这些都可以用show()实现,来个综合的例子

Ext.get("btMsg").on("click", function () {     
        Ext.MessageBox.show({
        title: "标题",
        msg: "详细信息内容",
        buttons: Ext.MessageBox.YESNOCANCEL,    //对话框的按钮组合
        multiline: false,                       //有文本框时,是否为多行文本框
        closable: false,                        //是否可关闭
        prompt: true,
        icon: Ext.MessageBox.WARNING,
        iconCls: "add16",
        width: 400,
        proxyDrag: true,
        value: "初始文本",
        progress: true,
        progressText: "加载中..",
        animateTarget: "bt3"
    });
        updateProgress(0);//前面定义过此函数
    });

ok,到此MessageBox告一段落!~

这样学起来,是否没有那么复杂咩?如果源码并不是很长的话,对理解方法如何使用是非常有用的。突然解了最开始ExtJS有些方法没有具体写出应用,自己该如何调用的问题。

参考文献:

主要还是API 有MessageBox、ProgressBar

Ext.MessageBox 消息对话框

自定义对话框Ext.MessageBox.show

ExtJS 教程目录-这个是总结的比较全的,可以参考去看看哦

posted @ 2014-02-19 23:02  易小亨  阅读(1295)  评论(0编辑  收藏  举报