Migration Notes (from 0.7.x)
Some notes about the things to be careful during the migration of the widgets for qooxdoo 1.2.
XXX
Simple Renamings
- addEventListener() => addListener()
- HorizontalBoxLayout => HBox
- VerticalBoxLayout => VBox
- qx.ui.core.Border => qx.ui.decoration.Single
- qx.ui.widget.Iframe.getContentDocument() => qx.ui.widget.Iframe.getDocument()
- createDispatchEvent() => fireEvent()
- createDispatchDataEvent() => fireDataEvent()
- qx.event.type.DataEvent => qx.event.type.Data
- qx.core.Object.dispose() => qx.core.ObjectRegistry.shutdown()
- getParent() => getLayoutParent()
- qx.io.Alias => qx.util.AliasManager
- qx.ui.embed.Iframe.getContentDocument() => qx.ui.embed.Iframe.getDocument()
- qx.ui.embed.Iframe.getContentWindow() => qx.ui.embed.Iframe.getWindow()
- qx.ui.basic.Label.setText() => qx.ui.basic.Label.setContent()
- #embed => #asset
- qx.application.???._postload() => qx.application.???.finalize()
- qx.ui.selection.RadioManager => qx.ui.form.RadioGroup
- beforeAppear => appear
More Elaborate Changes
- border => decorator
- Layout handling
- edge => left, top, right, bottom
- User agent handling
- qx.core.Client.getInstance().getEngine() => qx.bom.client.Engine.NAME
- Event handling:
- qx.html.EventRegistration => qx.event.Manager
- this.dispatchEvent(new qx.event.type.DataEvent("name", eventData), true) => this.fireDataEvent("name", eventData)
- mouse capture:
- setCapture(true) => capture()
- setCapture(false) => releaseCapture()
- getElement => getContainerElement().getDomElement()
- Layout properties
- _renderRuntimeXXX() => setUserBounds() or setLayoutProperties({left: 10, top: 10})
- setLeft(12) => setLayoutProperties({left: 12}) (in Canvas and Basic layouts)
- setTop(12) => setLayoutProperties({top: 12}) (in Canvas and Basic layouts)
- setRight(12) => setLayoutProperties({right: 12}) (in Canvas and Basic layouts)
- setBottom(12) => setLayoutProperties({bottom: 12}) (in Canvas and Basic layouts)
- over => hovered
- focus => focused
Deprecated
- Positions in the appearance
- ClientDocument. Use this.getRoot() in qx.application.Standalone instead.
- qx.util.Mime. Use strings explicitly
- addToDocument(). Use application.getRoot() instead
- qx.ui.SplitPaneKnob: style Splitter and Slider to show a knob
- qx.ui.core.Widget.isMaterialized => not needed any longer
- qx.ui.core.ClientDocument.isMaterialized => not needed any longer
- qx.core.Version no longer exists
Missing
- qx.io.local.CookieApi missing in 0.8 and 0.8.1 => Use native cookie handling. Releases 0.8.2 and beyong include (again) cookie handling.