React Native控件之TextInput组件介绍以及实际登录界面实现

（一）前言

这一篇文章讲解一下文本输入框TextInput组件使用讲解以及模仿实现一下贵州银行登录界面效果。

TextInput组件允许用户在应用中通过键盘进行输入文本信息。并且该组件还提供了多种配置属性：自动拼写修复、自动大小写切换、占位默认字符设置以及多种不同类型的键盘切换（数字键盘与字母键盘等之间的切换）。

（二）基本使用

TextInput组件和前面讲到的Image或者 Text组件差不多，用起来都很simple。我们直接在应用中添加一个TextInput组件，然后给该组件添加相关属性（例如：边框颜色、粗细、背景、默认值）以及监听方法（例如：刚输入回调、输入完成回调、焦点变化等事件）。看一下官方例子：

   <View style={styles.TextInputContainer}>                  <TextInput style={{borderWidth:1,borderColor:'red',height:40}}                      onChangeText={ (text) => this.setState({text}) }                      value={this.state.text}                  />               </View>TextInputContainer:{    marginTop:20,    marginLeft:10,    marginRight:10,    backgroundColor:'white'  },

这个例子直接定义了TextInput组件，同时设置组件的风格、高度、边框粗细以及边框颜色。而且，我们监听了TextInput的onChangeText事件来获取用户输入信息。还有其他监听事件，例如onSubmitEditing（提交编辑）、onFoucs（输入框获取焦点的时候调用）等相关的监听方法。

接下来我们进一步将例子加深：创建三个TextInput，同时每个TextInput都添加了默认值，第一个TextInput组件设置高度40，边框粗细和边框的颜色，而且可以输入多行信息。第二个TextInput设置左右额外边距以及自动获取焦点。第三个TextInput设置不可输入状态。直接上代码：

 <View style={styles.TextInputContainer}>                  <TextInput style={{height:40,borderColor:'green',borderWidth:1,marginTop:5}}                       multiline={true}                       defaultValue='默认信息1'                  />                  <TextInput style={{height:40,borderColor:'green',borderWidth:1,marginTop:5}}                       autoFocus={true}                       defaultValue='默认信息2'                  />                  <TextInput style={{height:40,borderColor:'green',borderWidth:1,marginTop:5}}                             editable={false}                       defaultValue='默认信息3'                  />               </View>

运行效果如下图：

（三）属性方法

名称 作用 值 平台 View支持的相关属性 一些基本属性 官网链接 iOS、Android autoCapitalize 自动切换成大写 enum(‘none’,’sentences’,’words’,’characters’) none:不自动切换任何字符成大写；sentences:默认每个句子的首字母变成大写；words:每个字母的首字母变成大写；characters:每个字母全部变成大写 iOS、Android autoCorrent 设置拼写自动修正功能，默认为开启(true) bool iOS、Android autoFocus 设置是否默认获取到焦点，默认为关闭(false)，componentDidMount方法被调用之后才会获取焦点(componentDidMount是React组件被渲染之后React系统回调的方法) bool iOS、Android defaultValue 给文本输入设置一个默认初始值 string iOS、Android editable 设置文本框是否可以编辑 bool iOS、Android keyboardType 键盘类型：用来选择默认弹出键盘的类型，例如指定numeric就是弹出数字键盘。 ‘default’, ‘email-address’, ‘numeric’, ‘phone-pad’, ‘ascii-capable’, ‘numbers-and-punctuation’, ‘url’, ‘number-pad’, ‘name-phone-pad’, ‘decimal-pad’, ‘twitter’, ‘web-search’,鉴于平台的原因如下的值是所有平台都可以进行通用:default,numeric,email-address iOS、Android maxLength 限制文本输入框最大的输入字符长度 number iOS、Android multiline 设置可以输入多行文字，默认为false(表示无论文本输入多少，都是单行显示) bool iOS、Android onBlur 监听方法，文本框失去焦点回调方法 function iOS、Android onChange 监听方法,文本框内容发生改变回调方法 function iOS、Android onChangeText 监听方法，文本框内容发生改变回调方法，该方法会进行传递文本内容 function iOS、Android onEndEditing 监听方法，当文本结束文本输入回调方法 function iOS、Android onFocus 监听方法 文本框获取到焦点回调方法 function iOS、Android onLayout 监听方法 组价布局发生变化的时候调用，调用方法参数为 {nativeFunction:{x,y,width,height}} function iOS、Android onSelectionChange 监听方法 当Text input选中状态被改变时调用 function iOS、Android onSubmitEditing 监听方法，当编辑提交的时候回调方法。不过如果multiline={true}的时候，该属性就不生效 function iOS、Android placeholder 当文本输入框还没有任何输入的时候，默认显示信息，当有输入的时候该值会被清除 string iOS、Android placeholderTextColor 设置placeholderText颜色 string iOS、Android returnKeyType 决定return键怎么显示 enum(‘done’, ‘go’, ‘next’, ‘search’, ‘send’, ‘none’, ‘previous’, ‘default’, ‘emergency-call’, ‘google’, ‘join’, ‘route’, ‘yahoo’)。双平台适用：done、go、next、search、send；Android：none、previous；iOS：default、emergency-call、google、join、route、yahoo iOS、Android secureTextEntry 设置是否为密码安全输入框 bool，默认为false iOS、Android selectTextOnFocus 如果为true，当获得焦点，自动选中所有文本 bool iOS、Android selectionColor 输入框文本的高亮颜色（iOS中包括光标） string iOS、Android style 风格属性，可以参考Text组件风格 iOS、Android value string iOS、Android numberOfLines 设置TextInput的行数，multiline设置为true，并结合该属性能够满足多行的TextInput number Android returnKeyLabel 设置return键为文本组件，利用它替换returnKeyType string android underlineColorAndroid 设置TextInput的下划线颜色 string android clearButtonMode 清除按钮模式,设置何时应该在TextInput右边出现清除按钮 enum(‘never’, ‘while-editing’, ‘unless-editing’, ‘always’) iOS clearTextOnFocus 如果为true，当编辑开始自动清除TextInput文本内容 bool iOS enablesReturnKeyAutomatically 如果为true，当没有输入文本键盘的return键自动失效，当输入文本键盘的return键自动生效，默认值是false bool iOS keyboardAppearance 设置键盘的颜色 enum(‘default’, ‘light’, ‘dark’) iOS onKeyPress 当任何一个键被按时调用，被按的键的值作为一个实参传入function，在onChange被调用之前先执行 function iOS selectionState 请看DocumentSelectionState.js一些状态负责维持一个文档的选中信息（我也不懂什么意思，官网翻译的。） DocumentSelectionState iOS

（四）方法（Methods）

1.isFocused()

返回值是boolean，判断当前TextInput组件当前是否获得焦点

2.clear()

移除所有输入的文本从TextInput组件。

（五）例子