一. 简介
TextInput是一个允许用户在应用中通过键盘输入文本的基本组件。本组件的属性提供了多种特性的配置，譬如自动完成、自动大小写、占位文字，以及多种不同的键盘类型（如纯数字键盘）等等。
二. 属性
- autoCapitalize enum('none', 'sentences', 'words', 'characters')
控制TextInput是否要自动将特定字符切换为大写：
characters: 所有的字符。
words: 每个单词的第一个字符。
sentences: 每句话的第一个字符（默认）。
none: 不自动切换任何字符为大写。 - autoCorrect bool
如果为false，会关闭拼写自动修正。默认值是true。 - autoFocus bool
如果为true，在componentDidMount后会获得焦点。默认值为false。 - blurOnSubmit bool
如果为true，文本框会在提交的时候失焦。对于单行输入框默认值为true，多行则为false。注意：对于多行输入框来说，如果将blurOnSubmit设为true，则在按下回车键时就会失去焦点同时触发onSubmitEditing事件，而不会换行。 - defaultValue string
提供一个文本框中的初始值。当用户开始输入的时候，值就可以改变。
在一些简单的使用情形下，如果你不想用监听消息然后更新value属性的方法来保持属性和状态同步的时候，就可以用defaultValue来代替。 - editable bool
如果为false，文本框是不可编辑的。默认值为true。 - keyboardType enum("default", 'numeric', 'email-address', "ascii-capable", 'numbers-and-punctuation', 'url', 'number-pad', 'phone-pad', 'name-phone-pad', 'decimal-pad', 'twitter', 'web-search')
决定弹出的何种软键盘的，譬如numeric（纯数字键盘）。
这些值在所有平台都可用：
default
numeric
email-address - maxLength number
限制文本框中最多的字符数。使用这个属性而不用JS逻辑去实现，可以避免闪烁的现象。 - multiline bool
如果为true，文本框中可以输入多行文字。默认值为false。 - onBlur function
当文本框失去焦点的时候调用此回调函数。 - onChange function
当文本框内容变化时调用此回调函数。 - onChangeText function
当文本框内容变化时调用此回调函数。改变后的文字内容会作为参数传递。 - onEndEditing function
当文本输入结束后调用此回调函数。 - onFocus function
当文本框获得焦点的时候调用此回调函数。 - onLayout function
当组件挂载或者布局变化的时候调用，参数为{x, y, width, height}。 - onSubmitEditing function
此回调函数当软键盘的确定/提交按钮被按下的时候调用此函数。如果multiline={true}，此属性不可用。 - placeholder string
如果没有任何文字输入，会显示此字符串。 - placeholderTextColor string
占位字符串显示的文字颜色。 - secureTextEntry bool
如果为true，文本框会遮住之前输入的文字，这样类似密码之类的敏感文字可以更加安全。默认值为false。 - selectTextOnFocus bool
如果为true，当获得焦点的时候，所有的文字都会被选中。 - selectionColor string
设置输入框高亮时的颜色（在iOS上还包括光标） - style
本组件继承了所有Text的样式。 - value string
文本框中的文字内容。
TextInput是一个受约束的(Controlled)的组件，意味着如果提供了value属性，原生值会被强制与value属性保持一致。在大部分情况下这都工作的很好，不过有些情况下会导致一些闪烁现象——一个常见的原因就是通过不改变value来阻止用户进行编辑。如果你希望阻止用户输入，可以考虑设置editable={false}；如果你是希望限制输入的长度，可以考虑设置maxLength属性，这两个属性都不会导致闪烁。 - clearButtonMode enum('never', 'while-editing', 'unless-editing', 'always') （ios）
是否要在文本框右侧显示“清除”按钮。 - clearTextOnFocus bool （ios）
如果为true，每次开始输入的时候都会清除文本框的内容。 - enablesReturnKeyAutomatically bool （ios）
如果为true，键盘会在文本框内没有文字的时候禁用确认按钮。默认值为false。 - keyboardAppearance enum('default', 'light', 'dark') （ios）
指定键盘的颜色。 - onKeyPress function （ios）
当一个键被按下的时候调用此回调。被按下的键会作为参数传递给回调函数。会在onChange之前调用。 - returnKeyType enum('default', 'go', 'google', 'join', 'next', 'route', 'search', 'send', 'yahoo', 'done', 'emergency-call') （ios）
决定“确定”按钮显示的内容。 - selectionState DocumentSelectionState （ios）
可以控制一个文档中哪段文字被选中的状态。 - numberOfLines number （android）
设置输入框的行数。当multiline设置为true时使用它，可以占据对应的行数。 - underlineColorAndroid string （android）
文本框的下划线颜色，如果要去掉文本框的边框，请将此属性设为透明transparent
三. 方法
- isFocused(): boolean
返回值表明当前输入框是否获得了焦点。 - clear()
清空输入框的内容。
四. 示例 文本框自动提示的搜索框
var onePT = 1 / PixelRatio.get();
class InputTextDemo extends Component {
render() {
return (
<View style={[styles.flex,styles.marginTop]}>
<Search></Search>
</View>
}
}
class Search extends Component {
constructor(props) {
super(props);
this.state = {
show: false,//是否显示匹配条目 value: null,//选中的值 }; }
hide(val) { this.setState({ show: false, value: val, }); }
getValue(text) { this.setState({ show: true, value: text, }); }
render() { return ( <View style={styles.flex}> <View style={styles.flexDirection}> <View style={[styles.flex,styles.input]}> <TextInput returnKeyType="search"//软键盘返回键 placeholder="请输入文字"//占位符 keyboardType="web-search" onChangeText={this.getValue.bind(this)}//监听输入字的改变 value={this.state.value}//匹配条目点击后选中的值 underlineColorAndroid="transparent" /> </View> <View style={styles.btn}> <Text style={styles.search} onPress={this.hide.bind(this,this.state.value)}>搜索</Text> </View> </View> {this.state.show? <View style={styles.result}> <Text onPress={this.hide.bind(this, this.state.value+"的习惯")} style={styles.item} numberOfLines={1}>{this.state.value}的习惯 </Text> <Text onPress={this.hide.bind(this, this.state.value+"的视频")} style={styles.item} numberOfLines={1}>{this.state.value}的视频</Text> <Text onPress={this.hide.bind(this, "呵呵"+this.state.value+"的文字")} style={styles.item} numberOfLines={1}>呵呵{this.state.value}的文字</Text> <Text onPress={this.hide.bind(this, this.state.value+"的图片")} style={styles.item} numberOfLines={1}>{this.state.value}的图片</Text> </View> :null } </View> ); } }
const styles = StyleSheet.create({ flex: { flex: 1 }, marginTop: { marginTop: 25, }, flexDirection: {//方向 因为RN默认是竖直方向 flexDirection: 'row', }, input: { borderWidth: 1, borderColor: 'red', height: 40, borderRadius: 5, paddingLeft: 10, marginLeft: 10, }, btn: { backgroundColor: '#23BEFF', height: 40, marginLeft: -5, marginRight: 5, width: 45, justifyContent: 'center', alignItems: 'center', }, search: { fontSize: 20, color: '#fff', fontWeight: 'bold', }, result: { marginTop: onePT, marginLeft: 18, marginRight: 10, height: 200, }, item: { fontSize: 16, paddingTop: 5, paddingBottom: 5, }, });
效果
输入文本
点击第一个条目
记录我自己的RN学习之路，纯属自己增值，有什么不对的地方，一起讨论进步
