ExtJs自学教程(1):一切从API开始

题 记

该系列文章不侧重全方位的去介绍ExtJs的使用,只是侧重于解决ExtJs问题的思考方法。写的人不用长篇大论,学的人则能够自立更生。l
  学习的人只要有一些CSS的javascript的基础知识并且对于英文不至于非常蹩脚(以辅助词霸能看懂ExtJs的API为准),都可以参考本教程进行修行。

《一》 一切从API开始

很多学ExtJs的朋友在初学ExtJs的时候觉得ExtJs的很简单效果很好,几行代码就把效果搞定了。但是用得多了,抱怨就开始
了:ExtJs的布局怎么这么麻烦啊。那些参数哪里来的呀?我想弄个效果怎么就弄不出来啦,然后风风火火的在论坛发一大堆帖子。发现没几个人睬,就得出结
论了:ExtJs不好用。但是能够很顺利的用ExtJs解决问题的人却大有人在,所以,不要抱怨酸葡萄了,想提高,还是得安安心心坐下来看帖子:)


学习前,首先得明白一个道理:所谓开发高手,解决问题自然比一般的常人要快。除了经验以外,其中能力最大的一方面,就是查找资料比一般常人要迅速。好比一
本武林秘籍,落到常人手里通常是没多大用处的,得“高人”点拨,先学点“内功心法”。对于ExtJs来说,“武林秘籍“就是ExtJs的API文档。所
以,学习ExtJs,首先得学会怎样去看API。因此,第一步,就是学习如何看ExtJs的API文档

下载ExtJs 2.0.2(ExtJs的最后一个免费版本)的开发包,解压缩后,能够看到有以下几个目录:

adapter   Extjs和其它JS开发包之间兼容使用的适配器,jquery,prototype和yui,还一个是ExtJs自己的
air       和adobe air整合用的
build     jsBuild出来的目录
docs      武林秘籍就这本了
examples  养眼的一些ExtJs官方例子,可供依葫芦画些瓢
source    JSBuild用的源,里面有个jsb项目文件,可以build出自己的Ext-all.js
resources ExtJs运行需要的资源文件,包括图标和CSS这些

如果你下载的ExtJs有这些非空目录,恭喜你,至少有80%可能证明你下载的这个ExtJs不是山寨版或阉割版。可以进一步学习了 ExtJs API的查看需要HTTP环境,这里推荐LiteServe。 绿色软件个头小,功能也足。当然你也可以用apache或IIS,然后把WEB根目录指向ExtJs的解压目录,例如:d:/ext-2.0.2,端口在 80运行。然后在服务器敲入地址:http://localhost/docs/,loading完毕后你就可以看到ExtJs API的界面如下

左边的树点击后,右边的标签页能添加该类的标签,并在页内显示该类的信息。以panel为例如下:


图你能够看到ExtJs的包,原始定义文件(build的src里对应的那个文件)
,相关类,继承的子类,父类以及一颗直观的继承树。然后接下来的区域“panel
is..”是该类的说明,该区域很重要,通常类的该区域可能给了该类的使用示例以及需要注意的地方。

接下来是配置,属性,方法和事件4部分。从上面图片可以看到,详细信息顶部给了到这4部分的链接:"Properties" "Methods" "Events" "Config Options"。
滚动鼠标便可以依次浏览该4部分:

首先出场的是Config Options,这些参数是创建类时构造方法的参数。如下:

你可以看到内容分3列:

第一列是一个小三角箭头。可以折叠和展开该参数说明。


二列是参数说明,如果说明区域还有内容未显示完,内容末尾会显示成“...”。如上图animCollapse
的部分,点第一列的箭头可以展开。activeItem参数那行就是展开后的效果。展开后显示该参数的说明,注意Config
Options里有很多参数都是有default属性的,也就是说。在new的时候的参数Objects不传入该参数,该参数默认就是使用default
的值,这样可以大大减少了使用时构造参数的数量。例如new一个panel,除了指定渲染的对象外,可以仅配置html的属性,例如:new
Ext.Panel({renderTo:‘panelDiv‘,html:‘内容‘});

一点特别要注意,就是传入config对象时,千万不要多了或漏了逗号。IE的对象定义格式要求很严格,对象最后一个成员不能以逗号结尾,否则JS载入时
就出错了。例如:new Ext.Panel({renderTo:‘panelDiv‘,html:‘内容‘,});
在FireFox3下可以通过,但是在IE6下会导致一个无法编译的错误。

第三列是定义类,由于javascript
也是OO的语法,因此子类也继承了父类的属性和方法。前面带有一个向上箭头的是继承的属性或方法,通常如果看某个类的特有功能(例如Panel类的折叠
collapse相关的方法),就需要找Difined By为当前类的说明行,这样就很方便。

对于Config
Options的使用,还有一个比较方便的地方,就是当指定Config
Options的xtype后,在ExtJs生成容器的子对象时,可以不用去new一个对象,而只需要传入配置对象,在对象里指定xtype即可。有些容
器的items有默认xtype,例如Ext.Panel的items传入配置对象默认的xtype就是‘panel‘,Ext.Panel的
buttons传入的配置对象默认的xtype就是button。例如,以下3种写法是等效的:

new Ext.Panel({
  renderTo: ‘panelDiv‘,
  items:[{
    html: ‘内容1‘
  },{
    html: ‘内容2‘
  }],
  buttons:[{
    text: ‘测试按钮‘
  }]
});

你也可以写成
new Ext.Panel({
  renderTo: ‘panelDiv‘,
  items:[{
    xtype: ‘panel‘,
    html: ‘内容1‘
  },{
    xtype: ‘panel‘,
    html: ‘内容2‘
  }],
  buttons:[{
    xtype: ‘button‘,
    text: ‘测试按钮‘
  }]
});

或者用new的方式
new Ext.Panel({
  renderTo: ‘panelDiv‘,
  items:[
    new Ext.Panel({
      html: ‘内容1‘
    }),
    new Ext.Panel({
      html: ‘内容2‘
    })
  ],
  buttons: [new Ext.Button({
    text: ‘测试按钮‘
  })]
});

显然,第一种写法比其它两种都要来得简单

接下来是Public Properties,该部分定义了对象的成员变量。可以直接通过点号来访问的,通常该部分都是只读的属性。如下:

该部分没什么好说的,对照着看说明就是了。唯一一个注意的就是initialConfig属性。说明上是这样的

initialConfig : Object
This Component‘s initial configuration specification. Read-only.

该属性可以直接访问你的初始化对象,这样可以节约了一些var变量,如果是传入config的对象,例如ToolBar之类。可以直接从initialConfig属性里得到。

再接下来是Public Methods,也就是公开的对象方法。该部分定义了对象的能够被访问的方法。


部分顺便说说方法的参数。对于javascript,其使用是比较“随意”的,没有对overload的支持,使得在编写时传入参数极其容易弄错。因此就
需要注意看参数类型,对于可以使用不同参数类型,之间是用/号间隔开的。例如上图的add方法,展开后可以看到各参数的详细使用方法,例如展开后里面有这
样来说明Object参数:

A Component config object may be passed in order to avoid the overhead of constructing a real Component object
那么就是说,可以直接把一个config对象传进去而不是一个Ext.Component对象。这样你就可以理解了,采用类似add({xtype:‘button‘,text:‘按钮‘})这样的写法也是可以的了。


以说,ExtJs的API是说明最全的ExtJs教程,比任何教程练习什么的都要强。当然,也有更深层次学习的部分,那就是得看ExtJs源码,看
ExtJs源码可以实现一些比API更强的功能,例如,把formLayout里的Ext.form.Radio进行横排。这就得看源码。

再接下来的部分也非常重要,如果要增加ExtJs对象的行为,除了扩展对象以外。最常见的就是添加侦听了。你常常会看到网上一些人编写Listener,而不知道那些参数是怎样使用的,这里就是你最值得学习的地方了。也就是接下来的:

Public Events


如,第一行active:(Ext.Panel
p),那么就是说,在这个对象的listeners里,你可以监听active这个方法,这个方法有一个参数p,传入的对象是Ext.Panel,通常,
如果传入的参数名称为当前类或其父类时,就是指对象本身,例如第2个Event的命名就很清楚:Ext.Container
this。不过你就不要在使用时,也命名变量叫this了,为啥?很简单,javascript关键字呗。

再接下来一行是该事件的发生条件:Fires after the Panel has been visually activated
这就说明该对象变成可视并活动时,将触发该事件。

看过API文档后,现在是否清楚了Event的使用了呢?如果不清楚那就看代码吧:

new Ext.Panel({
  renderTo: ‘panelDiv‘,
  title: ‘标题‘,
  items:[{
    xtype: ‘button‘,
    text: ‘按钮‘
  }],
  listeners:{
    afterlayout: function(panel, layout){
      alert(panel.getXType());
    }
  }
});

由于active是非直接调用的事件,因此改用afterlayout事件做示例,你可以尝试在afterlayout后的方法里用panel访问你new出来的这个对象的方法。你会发现ExtJs给的自由发挥的空间其实是非常强大!

ExtJs的事件监听,除了直接在对象创建时指定listeners外,还可以在对象创建后用on方法来实现动态的添加。API如是说:
on( String eventName, Function handler, [Object scope], [Object options] )
不想监听了,还可以用un移除掉:
un( String eventName, Function handler, [Object scope] )


有一点,也是非常值得注意的。就是虽然ExtJs的Component对象虽然都带有dom元素,也有dom元素支持的那些方法例如
click,resize。但是ExtJs的事件是扩展的。也就是,可能加入了ExtJs自己支持的一些特殊方法,而且行为,也可能与直接dom调用有一
些区别,例如resize方法:
resize : ( Ext.Component this, Number adjWidth, Number adjHeight, Number rawWidth, Number rawHeight )
  第一个元素是一个ExtJs对象,明显与html的dom元素有很大的区别,千万别弄混了。

时间: 2024-11-03 21:12:37

ExtJs自学教程(1):一切从API开始的相关文章

ExtJs自学教程(1):一切从API開始

题 记 该系列文章不側重全方位的去介绍ExtJs的使用,仅仅是側重于解决ExtJs问题的思考方法.写的人不用长篇大论,学的人则可以自立更生.l  学习的人仅仅要有一些CSS的javascript的基础知识而且对于英文不至于很蹩脚(以辅助词霸能看懂ExtJs的API为准),都可以參考本教程进行修行. <一> 一切从API開始 非常多学ExtJs的朋友在初学ExtJs的时候认为ExtJs的非常easy效果非常好,几行代码就把效果搞定了.可是用得多了,抱怨就開始了:ExtJs的布局怎么这么麻烦啊.那

ExtJs自学教程(1):从一切API开始

称号 记得 本系列文章是不是引进全套焦点ExtJs使用,您只需专注于解决ExtJs思考问题.人们不写长篇大论.别人能学会自立.l  有些人只要学会CSS的javascript基础知识并没有非常糟糕的英语(为了帮助金山词霸可以理解ExtJs的API任何).你可以参考本教程的实践. <一> 从一切API开始 学ExtJs的朋友在初学ExtJs的时候认为ExtJs的非常easy效果非常好.几行代码就把效果搞定了.可是用得多了,抱怨就開始了:ExtJs的布局怎么这么麻烦啊. 那些參数哪里来的呀?我想弄

ExtJs自学教程(2):从DOM看EXTJS

<二> 从DOM看EXTJS 看标题可能有人会问,为啥好好的例子不看,得从DOM看起呢?答案是目标只为了一个:自运行结果把EXTJS看得更清楚点 首先,要看得靠点工具,带点放大镜什么吧?对.我们需要的工具就是Internet Explorer Developer Toolbar(简 称IEDevToolBar),它是一个IE查看DOM的结构的工具,还具备Style Trace,Debug style的功能,可谓功能强劲.我们在IE下分析DOM结构,靠的就是它了.当然,如果你选择FireFox,

无废话ExtJs 入门教程十九[API的使用]

无废话ExtJs 入门教程十九[API的使用] extjs技术交流,欢迎加群(201926085) 首先解释什么是 API 来自百度百科的官方解释:API(Application Programming Interface,应用程序编程接口)是一些预先定义的函数,目的是提供应用程序与开发人员基于某软件或硬件的以访问一组例程的能力,而又无需访问源码,或理解内部工作机制的细节. ExtJs的Api必须部署到IIS上,ExtJS的API首页如下图所示: 左侧是搜索栏,可以搜索所有的Ext的组件,如上图

随笔分类 - 无废话ExtJs系列教程

摘自:http://www.cnblogs.com/iamlilinfeng/category/385121.html ExtJs 入门教程 摘要: extjs技术交流,欢迎加群(292467521):ExtJs 入门教程一[学习方法]ExtJs 入门教程二[Hello World]ExtJs 入门教程三[窗体:Window组件]ExtJs 入门教程四[表单:FormPanel]ExtJs 入门教程五[文本框:TextField]ExtJs 入门...阅读全文 posted @ 2012-12-

ExtJs 入门教程

ExtJs 入门教程一[学习方法] ExtJs 入门教程二[Hello World] ExtJs 入门教程三[窗体:Window组件] ExtJs 入门教程四[表单:FormPanel] ExtJs 入门教程五[文本框:TextField] ExtJs 入门教程六[按钮:Button] ExtJs 入门教程七[登陆窗体Demo:Login] ExtJs 入门教程八[脚本调试Firefox:firebug] ExtJs 入门教程九[数字字段:NumberField.隐藏字段Hidden.日期字段:

为何Python要从Web开始,才不会半途而废?【附整套web自学教程】

Python语言学习起来相对容易,这不可否认.但对于缺乏编程基础的人来说,Python依然很难,这也是事实. 学Python要从web开始?为什么? 一.因为能满足人的成就感 对于初学者,Python存在着较大的学习难度,这个难度不是来自技术,而是来自自己,学习的过程总是枯燥的,但如果能结合一个可视化的结果来学习,就会给自己带来成就感,也就有了学习动力. 二.因为能降低人的挫败感 用Python做web开发是比较简单的,有关于Python做web开发的教程网上也是很多,所以在web开发中遇到的大

无废话ExtJs 入门教程十七[列表:GridPanel]

无废话ExtJs 入门教程十七[列表:GridPanel] extjs技术交流,欢迎加群(201926085) 在Extjs中,GridPanel用于数据显示,即我们平时说的列表页.在本节中,我们先对GridPanel有个基本的认识,后继过程再做Demo练习详细讲解在开发中的应用. 1.代码如下: 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/

无废话ExtJs 入门教程十六[页面布局:Layout]

无废话ExtJs 入门教程十六[页面布局:Layout] extjs技术交流,欢迎加群(201926085) 首先解释什么是布局: 来自百度词典的官方解释:◎ 布局 bùjú: [distribution;layout] 对事物的全面规划和安排,布:陈设:设置. 我对布局理解是“把**东西放在**位置显示”[动词]. ok,我们这节课就讲一下怎么样把 ExtJs 的组件,放到我们想放置的位置. 一.常用布局 (1)ContainerLayout:默认布局方式,其他布局继承该类进行扩展功能.显示: