reactnative textinput 使用

1.TextInput介绍TextInput是一个允许用户通过键盘输入文本的的组件,该组件提供了多种配置的属性,如自动完成、自动大小写等等。注意:通过onChangeText从TextInput中获取用户录入的文本是目前唯一的方法。2.属性 - autoCapitalize: PropTypes.oneOf(['none','sentences','words','characters',]) 控制TextInput是否要自动的切换为大写。‘none’:不自动切换;‘sentences’:每句话的每一个字符(默认);‘word’:每个单词的第一个 字符;‘characters’:所有的字符。 - autoCorrect: PropTypes.bool,如果为false,自动关闭拼写修正,默认true。 - autoFocus: PropTypes.bool,如果为true,在componentDidMount后会获得焦点,默认false. - blurOnSubmit: PropTypes.bool,如果为true,文本框会在提交的时候失焦。对于单行输入框默认值为true,多行则为false。 注意:对于多行输入框来说,如果将blurOnSubmit设为true,则在按下回车键时就会失去焦点同时触发onSubmitEditing事件,而不会换行。 - defaultValue: PropTypes.node, 提供一个文本框中的初始值。当用户开始输入的时候,值就可以改变。 在一些简单的使用情形下,如果你不想用监听消息然后更新value属性的方法来保持属性和状态同步的时候,就可以用defaultValue来代替。 - value: PropTypes.string,文本框中的文字内容。 TextInput是一个受约束的(Controlled)的组件,意味着如果提供了value属性,原生值会被强制与value属性保持一致。在大部分情况下这都工作的很好, 不过有些情况下会导致一些闪烁现象——一个常见的原因就是通过不改变value来阻止用户进行编辑。 如果你希望阻止用户输入,可以考虑设置editable={false};如果你是希望限制输入的长度,可以考虑设置maxLength属性,这两个属性都不会导致闪烁。 - editable: PropTypes.bool,如果为false,文本框是不可编辑的。默认值为true。 - keyboardType: PropTypes.oneOf([ // Cross-platform 'default',//默认 'email-address',//email地址 'numeric',//数字键盘 'phone-pad',//手机 // iOS-only 'ascii-capable', 'numbers-and-punctuation', 'url', 'number-pad', 'name-phone-pad', 'decimal-pad', 'twitter', 'web-search', ])决定弹出的何种软键盘的,如numeric(纯数字键盘)。 - placeholder: PropTypes.node,如果没有任何文字输入,会显示此字符串。 - placeholderTextColor: ColorPropType,占位字符串显示的文字颜色。 - maxLength: PropTypes.number,限制文本框中最多的字符数。使用这个属性而不用JS逻辑去实现,可以避免闪烁的现象。 - multiline: PropTypes.bool,如果为true,文本框中可以输入多行文字。默认值为false。 - onBlur: PropTypes.func,当文本框失去焦点的时候调用此回调函数。 - onChange: PropTypes.func,当文本框内容变化时调用此回调函数。 - onChangeText: PropTypes.func,当文本框内容变化时调用此回调函数。改变后的文字内容会作为参数传递。 - onEndEditing: PropTypes.func,当文本输入结束后调用此回调函数。 - onFocus: PropTypes.func,当文本框获得焦点的时候调用此回调函数。 - onLayout: PropTypes.func,当组件挂载或者布局变化的时候调用,参数为{x, y, width, height}。 - onScroll: PropTypes.func,在内容滚动时持续调用,传回参数的格式形如{ nativeEvent: { contentOffset: { x, y } } }。 也可能包含其他和滚动事件相关的参数,但是在Android上,出于性能考虑,不会提供contentSize参数。 - onSelectionChange: PropTypes.func,长按选择文本时,选择范围变化时调用此函数,传回参数的格式 形如{ nativeEvent: { selection: { start, end } } }。 - onSubmitEditing: PropTypes.func,此回调函数当软键盘的确定/提交按钮被按下的时候调用此函数。如果multiline={true},此属性不可用。 - secureTextEntry: PropTypes.bool,如果为true,文本框会遮住之前输入的文字,这样类似密码之类的敏感文字可以更加安全。默认值为false。 - selectTextOnFocus: PropTypes.bool,如果为true,当获得焦点的时候,所有的文字都会被选中。 - selection: PropTypes.shape({ start: PropTypes.number.isRequired, end: PropTypes.number, }), - selectionColor: ColorPropType,设置输入框高亮时的颜色(在iOS上还包括光标)。 - returnKeyType: PropTypes.oneOf([ // Cross-platform 'done', 'go', 'next', 'search', 'send', // Android-only 'none', 'previous', // iOS-only 'default', 'emergency-call', 'google', 'join', 'route', 'yahoo', ]), /*@platform android*/ - disableFullscreenUI: PropTypes.bool. - inlineImageLeft: PropTypes.string. - inlineImagePadding: PropTypes.number. - returnKeyLabel: PropTypes.string. - textBreakStrategy: React.PropTypes.oneOf(['simple', 'highQuality', 'balanced']),. - numberOfLines: PropTypes.number. - underlineColorAndroid: ColorPropType. /*@platform ios*/ - spellCheck: PropTypes.bool, - clearButtonMode: PropTypes.oneOf([ 'never', 'while-editing', 'unless-editing', 'always', ]),是否要在文本框右侧显示“清除”按钮。 - clearTextOnFocus: PropTypes.bool,如果为true,每次开始输入的时候都会清除文本框的内容。 - enablesReturnKeyAutomatically: PropTypes.bool,如果为true,键盘会在文本框内没有文字的时候禁用确认按钮。默认值为false。 - dataDetectorTypes: PropTypes.oneOfType([ PropTypes.oneOf(DataDetectorTypes), PropTypes.arrayOf(PropTypes.oneOf(DataDetectorTypes)), ]), - keyboardAppearance: PropTypes.oneOf([指定键盘的颜色。 'default', 'light', 'dark', ]), - onKeyPress: PropTypes.func,当一个键被按下的时候调用此回调。传递给回调函数的参数为{ nativeEvent: { key: keyValue } }, 其中keyValue即为被按下的键。会在onChange之前调用。 - selectionState: PropTypes.instanceOf(DocumentSelectionState),可以控制一个文档中哪段文字被选中的状态。3.实例index.android.js和index.ios.js中代码:import './luancher'luancher.js代码import React, { Component } from 'react';import { AppRegistry,} from 'react-native';import Root from './inputText/root'AppRegistry.registerComponent('ImageDemo', () => Root);root.js代码:import React,{Component} from 'react'import { StyleSheet, Text, View, TextInput, Dimensions,} from 'react-native'const {width,height} = Dimensions.get('window')export default class Root extends Component{ constructor(props){ super(props) this.state = { inputText:'' } } render(){ return ( this.setState({inputText:text})}//文本内容发生变化时,执行回调函数,改变后的文本内容会作为参数传递 > 输出的文本:{this.state.inputText} ) }}const styles = StyleSheet.create({ container:{ flex:1, }, input:{ height:40, margin:10, }, text:{ marginLeft:10, }})

猜你喜欢

转载自blog.csdn.net/s349856186/article/details/78707608