TextField文本框,可以接受用户输入文字。它实现Field接口,支持数据绑定。基本用法:
// Create a text field
TextField tf = new TextField("A Field");
// Put some initial content in it
tf.setValue("Stuff in the field");
显示如下:
支持Field接口的UI组件,可以通过Property.ValueChangeListener 来监视Value的变化。可以通过方法getValue()来取代TextField的当前值。参考下面代码片段:
// Handle changes in the value
tf.addListener(new Property.ValueChangeListener() {
public void valueChange(ValueChangeEvent event) {
// Assuming that the value type is a String
String value = (String) tf.getValue();
// Do something with the value
getWindow().showNotification("Value is:", value);
}
});
// Fire value changes immediately when the field loses focus
tf.setImmediate(true);
TextField由AbstractTextField派生而来,因此继承了AbstractTextField的大部分API。下图为AbstractTextField的类关系图:
数据绑定
实现Field接口的UI组件支持数据绑定,TextField可以绑定到支持和 String 互换的数据类型。比如下面代码将TextField 绑定到一个Double数据变量。
// Have an initial data model. As Double is unmodificable and
// doesn't support assignment from String, the object is
// reconstructed in the wrapper when the value is changed.
Double trouble = 42.0;
// Wrap it in a property data source
final ObjectProperty<Double> property =
new ObjectProperty<Double>(trouble);
// Create a text field bound to it
TextField tf = new TextField("The Answer", property);
tf.setImmediate(true);
// Show that the value is really written back to the
// data source when edited by user.
Label feedback = new Label(property);
feedback.setCaption("The Value");
字符串长度
可以通过setMaxLenght() 指定文本框可以输入的字符串长度。为安全起见,TextField 的值传到服务器端时会截去超过最大长都的部分。
处理Null 值
TextField 可以绑定到某些支持Null值的数据源,如数据库的某个字段。此时,你可能想以某种特殊方式表示Null值,可以通过setNullRepresentation() 设置但当数据源为Null时显示内容。 setNullSettingAllowed 可以控制是否允许用客输入null 值,当setNullSettingAllowed 为假时,输入的Null 代表字符串null,而非Null值。
比如:
// Create a text field without setting its value
TextField tf = new TextField("Field Energy (J)");
tf.setNullRepresentation("-- null-point energy --");
// The null value is actually the default
tf.setValue(null);
// Allow user to input the null value by
// its representation
tf.setNullSettingAllowed(true);
// Feedback to see the value
Label value = new Label(tf);
value.setCaption("Current Value:");
结果如下:
Text 文本变化事件
除了通用的Property.ValueChangeListener 之外,TextField可以使用TextChangeListner 来监视Text内容的变化。immediate 模式实际上并非是立即触发Text内容变化事件,而是发生在TextField失去Focus后。
TextField 文本变化事件触发的时机有三种模式:TextChangeEventMode.LAZY
(缺省模式),TextChangeEventMode.TIMEOUT
和 TextChangeEventMode.EAGER
。
TextChangeEventMode.EAGER
表示每次按键都会触发事件,而TextChangeEventMode.TIMEOUT
表示每隔指定时间段时触发事件,而TextChangeEventMode.LAZY
则表示在输入暂停的某个时刻触发事件。
对于Web应用来说,使用缺省模式可以适用大部分情况。