|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface SafeSkinning
The skinning mechanism is extremely powerful and gives you the ability to change internal functionality of components. While this is useful for workarounds, you should think through any properties you override, considering what will happen with future versions of SmartGWT, where the defaults may change or be expanded.
The following kinds of overrides are generally very safe:
styleName
or baseStyle
to
provide a custom CSS style or series of styles
src
of the
minimizeButton
.
minimizeButton
, especially when this is done
to match the size of media you have created
showRollOver
that cause a component to
visually react to more or fewer UI states (disabled, over, down, etc)
Canvas.addShowContextMenuHandler(com.smartgwt.client.widgets.events.ShowContextMenuHandler)
). If future versions of the
component add more functionality, you may prevent new features from functioning, cause
them to function only partially, or break.
If you want to ensure that you do not break new functionality added in future SmartGWT
versions, be sure to call com.smartgwt.client..Class#Super
for methods you override, and do not
prevent events from bubbling.
If you want to ensure that only your custom behavior is used if a future version of a SmartGWT component adds functionality, override all methods involved in the interaction, even if your methods do nothing. For example, for a custom drop interaction, override dropOver, dropMove, dropOut and drop, even if you do nothing on dropMove(). Then, do not call Super() if there is no superclass behavior required for the interaction you've implemented. Also, for any event handlers (such as drop()) return false if you consider your code to have completely handled the event (no parent component should react).
ID
to a subcomponent (only works once).
backgroundColor
, border
,
margin
, padding
, or in general any single
attribute otherwise controlled by CSS. Future SmartGWT versions may change the base
CSS style, rendering your single-property customization senseless. Change the entire
CSS style via styleName
instead.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |