http://atian25.javaeye.com/blog/426310
郁悶...本來(lái)都寫(xiě)完的了...結(jié)果插入一個(gè)表格...JE編輯器就出問(wèn)題了...內(nèi)容不見(jiàn)了一半...格式也全亂了...得重來(lái)...
翻譯的不好,請(qǐng)多見(jiàn)諒。其中有些地方覺(jué)得太拗口了,就直接給出原文了,如果你有更好的翻譯,請(qǐng)跟帖,謝謝。
原文地址: http://extjs.com/forum/showthread.php?t=70352
Changes, Additions (roughly organized alphabetically)
1.Ext
- 新增:
- iterate 方法 - 遍歷一個(gè)數(shù)組或?qū)ο?對(duì)每個(gè)元素都執(zhí)行指定的函數(shù)
- isNumber 方法 - 判斷傳遞的參數(shù)對(duì)象是否是數(shù)字
- isString 方法 - 判斷傳遞的參數(shù)對(duì)象是否是字符串
- isBoolean 方法 - 判斷傳遞的參數(shù)對(duì)象是否是布爾值
- isDefined 方法 - 判斷傳遞的參數(shù)對(duì)象是否已經(jīng)定義
2.Ext.lib.Ajax
-
變更: Ajax responses. The
core adapter file in the Ext.lib.Ajax class has been changed in line
with the W3 XMLHttpRequest specification. The response object which emulates the XHR now has getResponseHeader and getAllResponseHeaders
as f unctions rather than Arrays to keep inline with the real XHR
object. So, anyone who was currenltly examining headers using an Array
(as inherited from YUI via yui-ext) will need to change to use a
function.
3.Ext.Componet
-
新增:
- A Component's Observable events may now be set to bubble up the Component-ownerCt axis.
4.Ext.BoxComponent
-
新增:
- getWidth()
- getHeight()
- getOuterSize()
5.Ext.Button
-
新增:
- Rather than being limited to only positioning buttons in a buttons
configuration, they can now be placed anywhere you please.
你的按鈕現(xiàn)在可以放在任意地方,而不僅限于buttons配置項(xiàng)
- Button現(xiàn)在可以縮放為任意高寬,并且有高級(jí)的文字布局。 (Buttons can now scale to any height or width and have advanced text positioning.)
- 新的配置:scale: 'small' , iconAlign : 'left' , arrowAlign : 'right'
-
變更:
- Button現(xiàn)在是一個(gè)有效的BoxComponent,可以被布局管理器管理。 (Button is now a valid BoxComponent and can partake in layout management. )
- Button的實(shí)現(xiàn)已經(jīng)完全重寫(xiě),所以舊版本時(shí)候?qū)懙淖远x樣式/主題需要相應(yīng)的修改。(The markup for buttons is
completely different and will require changes if you had implemented a
custom theme. )
6.Ext.Component
-
新增:
- afterrender事件
-
ref 配置項(xiàng) - establish a named reference for an object an ancestor Container (mitigate dependency on 'id' and Ext.getCmp).
- ptypes - ComponentMgr manages plugins similar to xtypes (use Ext.preg similar to Ext.reg)
- nextSibling
- previousSibling
- getDomPositionEl
7.Ext.ComponentMgr
-
新增:
- isRegistered 方法 - 檢查一個(gè)xtype是否已經(jīng)被注冊(cè)
8.Ext.Container
9.Ext.data.Reader
-
已過(guò)時(shí):
- 推薦使用id, 請(qǐng)用 propertyId 和 idIndex
10.Ext.data.Store
-
新增:
- store xtypes
-
autoDestroy 配置項(xiàng) - 當(dāng)store綁定的component被銷(xiāo)毀的時(shí)候,銷(xiāo)毀該Store
- setBaseParam()
-
變更:
- baseParams可以被load方法傳遞的同名參數(shù)所覆蓋。( baseParams may be overwritten by params of same name passed to load() )
-
已過(guò)時(shí):
- 不推薦使用 id ,請(qǐng)用 storeId 代替它
- 不推薦使用 loadexception 事件,請(qǐng)用 exception 事件
- SimpleStore 更名為 ArrayStore
11.Ext.Element
-
新增:
- mouseenter事件
- mouseleave事件
-
變更/已過(guò)時(shí):
- getAttributeNS() - 已過(guò)時(shí),用getAttribute()代替
- autoHeight() - 移除
- alignTo() - 變更參數(shù)"position"
- query() - 新增參數(shù)"unique"
- focus() - 新增參數(shù)"defer"
12.Ext.EventManager
-
變更:
- within() - can now also check if the passed element is the target or related target
13.Ext.form
-
新增:
- 當(dāng)動(dòng)態(tài)添加Container到FormPanel時(shí),Fields會(huì)被添加到BasicForm's的集合中。所以BasicForm's setValues 方法現(xiàn)在可以始終對(duì)動(dòng)態(tài)添加的Fields有效。(When dynamically adding Containers anywhere in a FormPanel, any Fields are now found and added to the BasicForm's Collection. So BasicForm's setValues method will now work consistently with dynamically added Fields.)
-
變更:
14.Ext.grid.GridPanel
-
新增:
-
- columnLines 配置項(xiàng) (boolean) - adds class ' x-grid-with-col-lines'
- Ext.grid.Column
- 用來(lái)作為columns參數(shù)傳遞給ColumnModel (Instances of this class are used as columns passed to ColumnModel)
- xtypes可以用來(lái)指定一些預(yù)先配置好的renderer(xtypes can be used to specify a preconfigured renderer)
- renderer may be specified in additional ways
- Grid RowEditor Class
- Grid like ListView and ListView.Sorter Classes (譯注:就是一個(gè)用DataView+XTemplate來(lái)模擬的Grid,輕量)
- Grid BufferedView Class. Buffered GridView enhances performance by
waiting to render rows until they are
visible.(譯注:對(duì)大數(shù)據(jù)量的Grid有明顯的性能提升,實(shí)際上就是只渲染用戶(hù)可見(jiàn)的列,拖動(dòng)的時(shí)候再渲染其他.官方還有其他的一個(gè)擴(kuò)展
Ext.ux.LiveGrid,詳見(jiàn):http://extjs.com/forum/showthread.php?t=17791)
15.Layouts:
-
新增:
- hbox布局和vbox布局
- 譯注:很有用的兩個(gè)布局。但區(qū)域見(jiàn)不能split,不過(guò)官方論壇有擴(kuò)展。詳見(jiàn)官方示例
- ToolbarLayout and MenuLayout (internally used by respective classes)
- Layout managers now defer layout of hidden or collapsed child
Components until such time as the child Component becomes visible or
expanded. This avoids size calculation problems in hidden/collapsed
Containers, and removes the need to use hideMode: 'offsets' (may even require that it be removed).
-
新增:
- Menu Overflow. Whenever a menu gets so long that the items won’t
fit the viewable area, it provides the user with an easy UI to scroll
the menu. This feature is turned on by default and can be disabled by
the configuration option
enableScrolling.(譯注:簡(jiǎn)單的說(shuō)就是Menu溢出后的滾動(dòng)效果,默認(rèn)是開(kāi)啟該效果,可以通過(guò)enableScrolling來(lái)配置,詳
見(jiàn)官方示例)
-
變更/已過(guò)時(shí):
- Toolbar and Menu are now proper Containers (formerly extended from BoxComponent). 現(xiàn)在Toolbar和Menu都繼承Container
- Breaking change:
MenuItem的ids現(xiàn)在已經(jīng)不是局部變量了,所以你不能在多個(gè)menu里面用一個(gè)id.建議:用唯一的id或者用itemIds來(lái)替代
它。(MenuItem ids are no longer local to their menu but global component
ids. This means that you can't use the same id in multiple menus.
Suggested fix: Use unique ids or switch to using itemIds.)
- As well as Menu being a Container, this also means Menu can be a
regular Component. Menu did not extend BoxComponent before, but was out
on its own. Now, it can behave either as a regular floating Menu, or,
if configured floating: false, it can be used as a usual inline
Component of a
Container.(譯注:簡(jiǎn)單的說(shuō)就是由于menu的繼承改變,現(xiàn)在你可以設(shè)置Menu為浮動(dòng)的,或者像平常的組件那樣使用它)
- DateItem和ColorItem已經(jīng)被移出,因?yàn)闆](méi)有必要了,現(xiàn)在你可以把任意組件放入menu的items中
- autoWidth() - 變更為autoSize()
17.Ext.MenuButton - 該類(lèi)已經(jīng)被移除,用SplitButton代替它
18.Ext.StatusBar - 該類(lèi)已經(jīng)被移出core庫(kù),在3.0final版會(huì)有個(gè)Ext.ux.StatusBar
19.Ext.Toolbar
-
新增:
- Toolbar Overflow. A menu for items that don’t fit the visible
toolbar area will be created by default and can be disabled with the
configuration option enableOverflow. Items in the menu react with the
same handlers as the toolbar items.(譯注:簡(jiǎn)單的說(shuō)就是Toolbar溢出后的滾動(dòng)效果詳見(jiàn)官方示例)
-
變更:
- Toolbar and Menu are now proper Containers (formerly extended from BoxComponent).現(xiàn)在Toolbar和Menu都繼承Container
20.Ext.Tooltip
-
新增:
-
delegate option added so one Tooltip can handle multiple child elements of its target based on selection using the delegate config.(譯注:新增的這個(gè)屬性很有用,就是通過(guò)設(shè)置的selector對(duì)某個(gè)元素的子對(duì)象設(shè)置Tip,在2.0的時(shí)候我們經(jīng)常需要的Gird RowTip,CellTip都可以實(shí)現(xiàn)了,不需要實(shí)例化很多Tip對(duì)象)
- AnchorTips - Tooltips now support an anchor configuration which
will allow you to bring attention to a particular element or component
with a small callout arrow.(譯注:簡(jiǎn)單的說(shuō)就是箭頭Tip,詳見(jiàn):http://extjs.com/deploy/dev/examples/simple-widgets/qtips.html)
21.Ext.util.Format
-
新增/變更:
- ellipsis() - "word" parameter added
- focus() - "defer" parameter added
- number() - added
- numberRenderer() - added
- plural() - added
22.Ext.util.Observable
-
新增:
- Ext.util.Observable.observeClass() - Class level observability 類(lèi)級(jí)別的觀察/通知
23.ux's that worked prior to 3.x may need some
tweaking (especially if the ux used private properties). ux's should be
checked they are utilizing the latest preferred techniques and
properties. More notes here. 舊的擴(kuò)展需要相應(yīng)的進(jìn)行修改,詳見(jiàn):
http://extjs.com/forum/showthread.php?p=338913#post338913
24.CSS. general updates, as well as refactoring to split css into visual and structural files to simplify theming.
26.新增:Ext.FlashComponent (譯注:似乎是用了swfobject,管理swf方便多了,不用adobe那又長(zhǎng)又臭的代碼)
28.新增:Writer
29.新增:Ext.Spacer - xtype 'spacer' (for empty box component)
33.新增:Ext.Error
Changes to some example classes: 示例類(lèi)的修改
(不敢用javaeye編輯器的表格了..自己將就著看吧...)
Class x(p)type Deprecates
Ext.ux.data.PagingMemoryProxy Ext.data.PagingMemoryProxy
Ext.ux.form.FileUploadField fileuploadfield Ext.ux.FileUploadField
Ext.ux.form.SelectBox selectbox Ext.ux.SelectBox
Ext.ux.form.SpinnerField spinnerfield Ext.form.SpinnerField (remove xtype=spinner)
Ext.ux.form.ItemSelector itemselector Ext.ux.ItemSelector
Ext.ux.form.MultiSelect multiselect Ext.ux.Multiselect
Ext.ux.grid.CheckColumn checkcolumn (p)
Ext.ux.grid.GroupSummary Ext.grid.GroupSummary
Ext.ux.grid.HybridSummary Ext.grid.HybridSummary
Ext.ux.grid.RowEditor roweditor (p)
Ext.ux.grid.RowExpander rowexpander (p) Ext.grid.RowExpander
Ext.ux.grid.TableGrid Ext.grid.TableGrid
Ext.ux.GMapPanel gmappanel
Ext.ux.SliderTip
Ext.ux.SlidingPager
Ext.ux.Spinner
Ext.ux.Spotlight Ext.Spotlight
Ext.ux.Statusbar Ext.Statusbar
Ext.ux.TabCloseMenu tabclosemenu (p)
Ext.ux.tree.ColumnTree columntree Ext.tree.ColumnTree
Ext.ux.tree.ColumnNodeUI Ext.tree.ColumnNodeUI
Ext.ux.tree.XmlTreeLoader Ext.ux.XmlTreeLoader
Changes to Resources 資源的變更
- Ensure you have updated all the Ext-provided CSS with the new CSS from version 3.
- Ensure you have updated all the Ext-provided images with the new images from version 3.
Additional References 其他參考