com.threerings.gwt.ui

Class Bindings

java.lang.Object

com.threerings.gwt.ui.Bindings

public class Bindings
extends Object

Handles the binding of various widget states to dynamic Values.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Bindings.Thunk Used to defer the creation of a widget.

Constructor Summary

Constructors

Constructor and Description
Bindings()

Method Summary

Methods

Modifier and Type	Method and Description
static void	bindDown(Value<Boolean> value, ToggleButton toggle) Binds the specified toggle button to the supplied boolean value.
static void	bindEnabled(Value<Boolean> value, FocusWidget... targets) Binds the enabledness state of the target widget to the supplied boolean value.
static <T extends HasMouseOverHandlers & HasMouseOutHandlers> void	bindHovered(Value<Boolean> value, T... targets) Binds the hovered state of the supplied target widgets to the supplied boolean value.
static void	bindLabel(Value<String> value, HasText target) Binds the specified string value to the supplied text-having widget.
static void	bindStateStyle(Value<Boolean> value, String onStyle, String offStyle, Widget... targets) Configures either `onStyle` or `offStyle` on the supplied target widgets depending on the state of the supplied boolean `value`.
static void	bindText(Value<String> value, TextBoxBase text) Binds the contents of the supplied text box to the supplied string value.
static void	bindVisible(Value<Boolean> value, Bindings.Thunk thunk) Binds the visible state of a to-be-created widget to the supplied boolean value.
static void	bindVisible(Value<Boolean> value, Widget... targets) Binds the visible state of the target widget to the supplied boolean value.
static ClickHandler	makeToggler(Value<Boolean> value) Returns a click handler that toggles the supplied boolean value when clicked.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Bindings

public Bindings()

Method Detail

bindEnabled

public static void bindEnabled(Value<Boolean> value,
               FocusWidget... targets)

Binds the enabledness state of the target widget to the supplied boolean value.

bindVisible

public static void bindVisible(Value<Boolean> value,
               Widget... targets)

Binds the visible state of the target widget to the supplied boolean value.

bindVisible

public static void bindVisible(Value<Boolean> value,
               Bindings.Thunk thunk)

Binds the visible state of a to-be-created widget to the supplied boolean value. The supplied thunk will be called to create the widget (and add it to the appropriate parent) the first time the value transitions to true, at which point the visiblity of the created widget will be bound to subsequent changes of the value.

bindHovered

public static <T extends HasMouseOverHandlers & HasMouseOutHandlers> void bindHovered(Value<Boolean> value,
                                                                     T... targets)

Binds the hovered state of the supplied target widgets to the supplied boolean value. The supplied value will be toggled to true when the mouse is hovering over any of the supplied targets and false otherwise.

bindDown

public static void bindDown(Value<Boolean> value,
            ToggleButton toggle)

Binds the specified toggle button to the supplied boolean value. The binding will work both ways: interactive changes to the toggle button will update the value and changes to the value will update the state of the toggle button.

bindLabel

public static void bindLabel(Value<String> value,
             HasText target)

Binds the specified string value to the supplied text-having widget. The binding is one-way, in that only changes to the value will be reflected in the text-having widget. It is expected that no other changes will be made to the widget.

bindText

public static void bindText(Value<String> value,
            TextBoxBase text)

Binds the contents of the supplied text box to the supplied string value. The binding is multidirectional, i.e. changes to the value will update the text box and changes to the text box will update the value. The value is updated on key up as well as on change so that both keyboard initiated changes and non-keyboard initiated changes (paste) are handled.

makeToggler

public static ClickHandler makeToggler(Value<Boolean> value)

Returns a click handler that toggles the supplied boolean value when clicked.

bindStateStyle

public static void bindStateStyle(Value<Boolean> value,
                  String onStyle,
                  String offStyle,
                  Widget... targets)

Configures either `onStyle` or `offStyle` on the supplied target widgets depending on the state of the supplied boolean `value`.

Parameters:

onStyle - the style name to be applied when the value is true, or null.

offStyle - the style name to be applied when the value is false, or null.