文本输入框是一个允许用户在应用中通过键盘输入文本的基本组件,相当于OC中的UITextField。
一、TextInput组件常用的属性及方法
(一)property
(1)autoCapitalize:控制输入的字符进行切换成大写(参数:none:不自动切换任何字符大写,sentences:默认每个句子的首字母大写,words:每个单词的首字母变成大写,characters:每个字母全部变成大写)
(2)autoCorrect(bool):设置瓶邪自动修正功能,默认开启(true)
(3)autoFocus(bool):设置是否默认获取到焦点,默认为关闭(false).需要comonentDidMount方法调用之后才会获取焦点(componentDidMount是React组件被渲染之后React主动回调的方法)
(4)defaultValue(string):给文本框输入一个默认初始值.
(5)editable(bool):设置文本框是否可以编辑,默认为true,可以进行编辑
(6)keyboard(type):
键盘类型(可选参数:"default", 'email-address', 'numeric', 'phone-pad', "ascii-capable", 'numbers-and-punctuation', 'url', 'number-pad', 'name-phone-pad', 'decimal-pad', 'twitter', 'web-search') 该用来选择默认弹出键盘的类型例如我们甚至numeric就是弹出数字键盘。
鉴于平台的原因如下的值是所有平台都可以进行通用的
- default
- numeric 数字键盘
- email-address 邮箱地址
(7)maxLength(number):可以限制文本输入框最大的输入字符长度
(8)multiline (bool) : 设置可以输入多行文字,默认为false(表示无论文本输入多少,都是单行显示)
(9)placeholder (string) :当文本输入框还没有任何输入的时候,默认显示信息,当有输入的时候该值会被清除
(10)placeholderTextColor (string): 设置默认信息颜色(placeholer)
(11)secureTextEntry (bool): 设置是否为密码安全输入框 ,默认为false
(12)numberOfLines (number):设置文本输入框行数,该需要首先设置multiline为true,设置TextInput为多行文本。
(13)textAlign 设置文本横向布局方式 可选参数('start', 'center', 'end')
(14)textAlignVertical: 设置文本垂直方向布局方式 可选参数('top', 'center', 'bottom')
(15)underlineColorAndroid: 设置文本输入框下划线的颜色(去掉下划线'transparent')
(16)clearButtonMode:清除按钮出现的时机
- never:不出现
- while-editing:编辑的时候出现
- unless-editing:没有编辑时出现
- always:总是出现
(17)clearTextOnFocus:如果为true,每次开始输入的时候都会清除文本框的内容
(18) returnKeyType:决定返回键的样式
- default
- go
- join
- next
- route
- search
- send
- yahoo
- done
- emergency-call
(19)value ( string ):输入框中的内容值
(20)selectionColor:可以修改光标颜色
(二)function
(1)onBlur (function): 监听方法,文本框失去焦点回调方法
(2)onChange (function): 监听方法,文本框内容发生改变回调方法
(3)onChangeText (function):监听方法,文本框内容发生改变回调方法,该方法会进行传递文本内容( onChangeText={(Password) => this.setState({Password})})
(4)onEndEditing (function):监听方法,当文本结束文本输入回调方法
(5)onFocus (function) :监听方法 文本框获取到焦点回调方法
(6)onLayout (function):监听方法 组价布局发生变化的时候调用,调用方法参数为 {x,y,width,height}
(7)onSubmitEditing (function):监听方法,当编辑提交的时候回调方法。不过如果multiline={true}的时候,该属性就不生效
(三)主动获取和释放键盘
(1)主动获取调用键盘this._textInput.focus() (this._textInput为当前文本框的引用)
this._textInput = component}/>
(2)主动撤销键盘this._textInput.blur()