Description:
The widget's view is composed by HTML elements such as text display area, buttons, edit fields, and so on. The appearance of these HTML elements can be dynamically changed. For example, they can be shown or hidden dynamically using the HTML DOM style object to set the display property to "block" or "none" respectively. For instance:
To show an element, call [object].style.display = "block"
To hide an element, call [object].style.display = "none"
The purpose of the prepareForTransition method
is to prepare a widget for a transition state before modifying the widget
view by disabling updates to the widget UI. Thus, when modifying a widget
view where the appearance of many HTML elements will be changed, prepareForTransition will
help to prevent the widget UI from being updated at once and one by one, which
could potentially cause screen flickering.
Syntax:
[void] widget.prepareForTransition(String transitionMode)
or
[void] window.widget.prepareForTransition(String transitionMode)
Arguments:
transitionMode:
A text string defining a desired transition mode. Currently the only supported transition mode is "fade", which causes the widget's view changing in fading mode.
Return value:
This method does not return a value.
Remarks:
This method is to be used together with the performTransition method. A widget's screen is not updated until the performTransition method is called.
Example code:
See the performTransition example
code.