美文网首页React Native
React Native 之组件TextInput

React Native 之组件TextInput

作者: 代码森林中的一只猫 | 来源:发表于2017-11-15 17:26 被阅读0次

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

    <TextInput ref={component => this._textInput = component}/>
    

    (2)主动撤销键盘this._textInput.blur()

    相关文章

      网友评论

        本文标题:React Native 之组件TextInput

        本文链接:https://www.haomeiwen.com/subject/hqjhvxtx.html