TextInput组件
样式键:
TextInput组件可以使用View组件和Text组件的所有样式键,它没有自己特有的样式键。
- autoCapitalize:取值有:none、sentences、words、characters,分别表示不自动变为大写、将每句话的首字母自动改为大写、将每个单词的首字母自动改为大写、将每个英文字母自动改为大写;
- autoCorrect:用来定义TextInput组件是否自动更正用户的输入。默认值true,默认自动更正检查用户输入的英语单词是否正确。
- autoFocus:用来定义TextInput组件是否自动获得焦点。默认值是false。
- blurOnSubmit:取值为:false、true。当它为true时,在输入框输入完成提交时,文本区域会被模糊化。它的默认值是TextInput组件multiline属性的非值。如果一个TextInput组件的multiline属性与blurOnSubmit都为true时,用户按下键盘上的回车键时会模糊化输入的文本并触发onSunmitEditing事件,而不是在输入区域插入新行。
- defaultValue:用来定义TextInput组件中的字符串默认值。
- editable:用来定义TextInput组件是否允许用户修改组件内的字符。取值为:false、true。当其值为false时,不允许修改。
- keyboardType:取值为:default、numeric、emial-address、ascii-capable、numbers-and-punctuation、url、number-pad、phone-pad、name-phone-pad、decimal-pad、twitter、web-search.它定义了当TextInput组件获得焦点时,将自动弹出哪种软键盘。default、numeric、email-address这三种是android平台和ios平台都支持的键盘类型。
- maxLength:用来定义TextInput组件最多允许用户输入多少个字符。
- multiline:取值为:false、true。当为true时,TextInput可以是多行的组件。默认值是false。
- placeholderTextColor:定义了placeholder字符串的颜色。
- returnKeyType:取值为:done、go、next、search、send。仅android平台支持的值为:none、previous,仅ios平台支持的值为:default、google、join、route、Y、yahoo、emergency-call.表示当TextInput组件获得焦点时,它定义了回车键在键盘布局中的外表。
- secureTextEntry和password:它们中只需要定义一个即可。定义了当前TextInput组件是否用于输入密码。取值为:false、true。
- selectTextOnFocus:取值为:false、true。当它为true时。如果TextInput组件获得焦点,则组件中所有的文字都会被选中。
- selection:用来设置TextInput组件中被选择字符的开始与结束位置。如果把开始位置与结束位置设为同一个值,可以达到设置输入光标至该位置的效果。它是一个对象类型的属性,接受的对象的结构为:
{
start:number,
end:number
}
- selectionColor:用来设置被选中的文字的高亮显示颜色。
- value:用来设置TextInput组件内字符串的值。要慎重使用这个属性,因为它有可能会带来屏幕显示闪烁。推荐使用editable属性和defaultValue属性来达到相同的效果。但当需要突然改变TextInput组件内字符串的值时,还是需要使用这个属性。
- onSelectionChange:回调函数的属性。当用户在文本输入框中选择的字符串发生改变时,这个回调函数将被调用,并且会被传入一个event参数。
TextInput组件的成员函数:
TextInput组件有一个名为isFocused的成员函数,当得到一个TextInput组件的引用后,,则可以判断当前这个TextInput组件是否获得焦点。
TextInput组件有一个名为clear的成员函数,用来讲TextInput组件中的字符串清空。