React Native 之组件TextInput

文本输入框是一个允许用户在应用中通过键盘输入文本的基本组件,相当于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
  • google
  • 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()

你可能感兴趣的:(React Native 之组件TextInput)