http://atian25.javaeye.com/blog/426310
郁悶...本來都寫完的了...結(jié)果插入一個表格...JE編輯器就出問題了...內(nèi)容不見了一半...格式也全亂了...得重來...
翻譯的不好,請多見諒。其中有些地方覺得太拗口了,就直接給出原文了,如果你有更好的翻譯,請跟帖,謝謝。
原文地址: http://extjs.com/forum/showthread.php?t=70352
Changes, Additions (roughly organized alphabetically)
1.Ext
- 新增:
- iterate 方法 - 遍歷一個數(shù)組或?qū)ο?對每個元素都執(zhí)行指定的函數(shù)
- isNumber 方法 - 判斷傳遞的參數(shù)對象是否是數(shù)字
- isString 方法 - 判斷傳遞的參數(shù)對象是否是字符串
- isBoolean 方法 - 判斷傳遞的參數(shù)對象是否是布爾值
- isDefined 方法 - 判斷傳遞的參數(shù)對象是否已經(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配置項
- Button現(xiàn)在可以縮放為任意高寬,并且有高級的文字布局。 (Buttons can now scale to any height or width and have advanced text positioning.)
- 新的配置:scale: 'small' , iconAlign : 'left' , arrowAlign : 'right'
-
變更:
- Button現(xiàn)在是一個有效的BoxComponent,可以被布局管理器管理。 (Button is now a valid BoxComponent and can partake in layout management. )
- Button的實現(xiàn)已經(jīng)完全重寫,所以舊版本時候?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 配置項 - 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 方法 - 檢查一個xtype是否已經(jīng)被注冊
8.Ext.Container
9.Ext.data.Reader
-
已過時:
- 推薦使用id, 請用 propertyId 和 idIndex
10.Ext.data.Store
-
新增:
- store xtypes
-
autoDestroy 配置項 - 當(dāng)store綁定的component被銷毀的時候,銷毀該Store
- setBaseParam()
-
變更:
- baseParams可以被load方法傳遞的同名參數(shù)所覆蓋。( baseParams may be overwritten by params of same name passed to load() )
-
已過時:
- 不推薦使用 id ,請用 storeId 代替它
- 不推薦使用 loadexception 事件,請用 exception 事件
- SimpleStore 更名為 ArrayStore
11.Ext.Element
-
新增:
- mouseenter事件
- mouseleave事件
-
變更/已過時:
- getAttributeNS() - 已過時,用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)動態(tài)添加Container到FormPanel時,Fields會被添加到BasicForm's的集合中。所以BasicForm's setValues 方法現(xiàn)在可以始終對動態(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 配置項 (boolean) - adds class ' x-grid-with-col-lines'
- Ext.grid.Column
- 用來作為columns參數(shù)傳遞給ColumnModel (Instances of this class are used as columns passed to ColumnModel)
- xtypes可以用來指定一些預(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 (譯注:就是一個用DataView+XTemplate來模擬的Grid,輕量)
- Grid BufferedView Class. Buffered GridView enhances performance by
waiting to render rows until they are
visible.(譯注:對大數(shù)據(jù)量的Grid有明顯的性能提升,實際上就是只渲染用戶可見的列,拖動的時候再渲染其他.官方還有其他的一個擴(kuò)展
Ext.ux.LiveGrid,詳見:http://extjs.com/forum/showthread.php?t=17791)
15.Layouts:
-
新增:
- hbox布局和vbox布局
- 譯注:很有用的兩個布局。但區(qū)域見不能split,不過官方論壇有擴(kuò)展。詳見官方示例
- 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.(譯注:簡單的說就是Menu溢出后的滾動效果,默認(rèn)是開啟該效果,可以通過enableScrolling來配置,詳
見官方示例)
-
變更/已過時:
- Toolbar and Menu are now proper Containers (formerly extended from BoxComponent). 現(xiàn)在Toolbar和Menu都繼承Container
- Breaking change:
MenuItem的ids現(xiàn)在已經(jīng)不是局部變量了,所以你不能在多個menu里面用一個id.建議:用唯一的id或者用itemIds來替代
它。(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.(譯注:簡單的說就是由于menu的繼承改變,現(xiàn)在你可以設(shè)置Menu為浮動的,或者像平常的組件那樣使用它)
- DateItem和ColorItem已經(jīng)被移出,因為沒有必要了,現(xiàn)在你可以把任意組件放入menu的items中
- autoWidth() - 變更為autoSize()
17.Ext.MenuButton - 該類已經(jīng)被移除,用SplitButton代替它
18.Ext.StatusBar - 該類已經(jīng)被移出core庫,在3.0final版會有個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.(譯注:簡單的說就是Toolbar溢出后的滾動效果詳見官方示例)
-
變更:
- 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.(譯注:新增的這個屬性很有用,就是通過設(shè)置的selector對某個元素的子對象設(shè)置Tip,在2.0的時候我們經(jīng)常需要的Gird RowTip,CellTip都可以實現(xiàn)了,不需要實例化很多Tip對象)
- 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.(譯注:簡單的說就是箭頭Tip,詳見: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 類級別的觀察/通知
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)行修改,詳見:
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那又長又臭的代碼)
28.新增:Writer
29.新增:Ext.Spacer - xtype 'spacer' (for empty box component)
33.新增:Ext.Error
Changes to some example classes: 示例類的修改
(不敢用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 其他參考