Ext js-02 -官方API文档使用

官方API文档地址：

http://docs.sencha.com/extjs/6.5.3/classic/Ext.html

打开网页如下：

1.选择所使用的Ext js版本，后面offline docs是离线文档的下载

2.搜索功能：查找类，组件等

需要注意这个API下面modern是手机端对应的组件，classic对用的是电脑端的组件的介绍

例子：搜索messagebox,选择第二个Ext.window.MessageBox，打开如下：

3.看懂API对组件的介绍：如单例对象，组件类，xtype，config配置，properties配置，methods方法，events事件，继承体系等

（1）单例对象与组件类：

点击左侧的Ext ,在显示的界面上会看到一个SINGLETON的标识，表示这是一个单例对象（注意，单例对象前面显示的是红色的图标），在整个应用当中，只有一个Ext对象，

下边configs,properties，methods是这个单例对象具有的一些属性，方法等

搜索messagebox时，会出现Ext.window.MessageBox，和Ext.MessageBox，后者是一个单例对象，如上图，而Ext.window.MessageBox是一个组件（每一个组件都是一个类），Ext.window.MessageBox 指明了 Ext.MessageBox这个对象所属的类是哪一个类，xtype 相当于一个别名，方便使用。

（2）configs 的使用，先关注一下类搜索和成员搜索的区别，是不同的搜索框

以Ext.MessageBox为例

上边fn就是alert方法的回调函数，也就是alert方法执行完后再执行的函数，scope是回调函数执行的范围，以例子说明如下：

 1 <!DOCTYPE html>
 2 <html lang="en">
 3 <head>
 4     <meta charset="UTF-8">
 5     <title>ext js入门</title>
 6     <!-- 引入ext js 的样式文件-->
 7     <link rel="stylesheet" type="text/css" href="ext/classic/theme-triton/resources/theme-triton-all.css" />
 8     <!-- 引入ext js的核心库-->
 9     <script src="ext/ext-all.js"></script>
10     <script>
11        // alert("js原生弹出框 ：hello");
12        //需要Extjs框架初始化完成才能执行
13        Ext.onReady(function(){
14            //使用ext 弹出框的回调函数
15            Ext.MessageBox.alert('Ext弹出框','hello world',function () {
16                console.log('ext js'); //在控制台打印内容
17            });
18        })
19     </script>
20 </head>
21 <body>
22 
23 </body>
24 </html>

执行过程：

常用组件panel的使用

这里使用new关键字来创建一个panel对象，格式为 new Ext.panel.Panel({ 需要配置的参数列表 })，这里需要配置的参数，把鼠标放在configs上面就显示出来可选的配置参数了：

使用create方式创建对象：格式为： Ext.create('类的名字,{属性配置 }) ，或者直接搜索Panel这个类下面的create方法，给出了create方法的使用说明：

 1 <!DOCTYPE html>
 2 <html lang="en">
 3 <head>
 4     <meta charset="UTF-8">
 5     <title>ext-panel使用</title>
 6     <!-- 引入ext js 的样式文件-->
 7     <link rel="stylesheet" type="text/css" href="ext/classic/theme-triton/resources/theme-triton-all.css" />
 8     <!-- 引入ext js的核心库-->
 9     <script src="ext/ext-all.js"></script>
10     <script>
11 
12        Ext.onReady(function(){
13            //不同于单例对象，panel对象需要自己创建，第一种方式：new对象
14           var panel =  new Ext.panel.Panel({
15                 300,
16                 height:150,
17                 title:'面板标题',
18                 html:'面板显示的内容',//指定显示的内容
19                 renderTo: 'dd',//面板必须要进行渲染才进行显示,配置这个panel在哪里显示
20            })
21            //使用create方法 格式为： Ext.create('类的名字,{属性配置 })
22            Ext.create('Ext.panel.Panel',{
23                300,
24                height:150,
25                title:'面板2',
26                html:'面板2显示的内容',//指定显示的内容
27                //renderTo: 'dd2',
28                renderTo:Ext.getBody()
29            })
30        })
31     </script>
32 </head>
33 <body>
34 <div id="dd"></div>&nbsp;&nbsp;
35 </body>
36 </html>

也可以使用 Ext.getBody() 来获取body这个对象，让panel显示在html的body中，运行如下：

（Ext.get获取到的直接是Ext的对象，在创建的时候就进行渲染 不像jquery中获取到的是DOM元素，需要用$()转换为jquery对象）

第三种方式创建panel对象，格式为 Ext.create({xtype:' ' ,对象属性 })

//通过别名获取panel对象Ext.create({xtype:'',对象属性  })
var panel3 = Ext.create({
    xtype:'panel',
    300,
    height:150,
    title:'面板3',
    html:'面板3显示的内容',//指定显示的内容
})
panel3.render(Ext.getBody()) //在指定时刻渲染

（3）properties:属性

用来判断，查看，例如console.log(panel3.draggable); //打印面板的拖拽属性的值

（4）methods

当前组件拥有的一些方法，直接使用对象.方法名()就能调用了，如、panel3.close() ，关闭面板

（5）events 事件

例如：控制台打印 panel3.draggable的值后，关闭面板，当监听到关闭事件时，又开始执行关闭事件的回调函数，在控制台打印关闭

在组件配置时使用listeners:{} 属性来设置事件监听：

 1  //通过别名获取panel对象Ext.create({xtype:'',对象属性  })
 2            var panel3 = Ext.create({
 3                xtype:'panel',
 4                300,
 5                height:150,
 6                title:'面板3',
 7                html:'面板3显示的内容',//指定显示的内容
 8                listeners:{
 9                    close:function(){
10                        console.log("关闭...")
11                    }
12                }
13            })
14            panel3.render(Ext.getBody()) //在指定时刻渲染
15            console.log(panel3.draggable); //
16            panel3.close()

使用on方法监听组件的事件：对象.on('事件名称',function () { 回调函数要执行的业务 }

 1 var panel3 = Ext.create({
 2                xtype:'panel',
 3                300,
 4                height:150,
 5                title:'面板3',
 6                html:'面板3显示的内容',//指定显示的内容
 7                listeners:{
 8                    close:function(){
 9                        console.log("关闭...")
10                    }
11                }
12            })
13            panel3.on('close',function () {
14                console.log("使用on监听事件...")
15            })
16            panel3.render(Ext.getBody()) //在指定时刻渲染
17            console.log(panel3.draggable); //
18            panel3.close()

使用addListener() 方法来监听事件：对象.addListener('事件名称',function () { 事件的回调函数执行的业务 } )

 1 var panel3 = Ext.create({
 2                xtype:'panel',
 3                300,
 4                height:150,
 5                title:'面板3',
 6                html:'面板3显示的内容',//指定显示的内容
 7                listeners:{
 8                    close:function(){
 9                        console.log("关闭...")
10                    }
11                }
12            })
13            panel3.on('close',function () {
14                console.log("使用on监听事件...")
15            })
16            panel3.addListener('close',function () {
17                console.log("使用addListener方法监听事件...")
18            })
19            panel3.render(Ext.getBody()) //在指定时刻渲染
20            console.log(panel3.draggable); //
21            panel3.close()

运行结果如下：

从上面可以看出，事件是可以叠加的