React Native 常用组件之 TextInput

一、前言

文本输入框,相当于OC中的UITextField,在用法和属性方面,两者都有很大的借鉴之处:通过键盘将文本输入到应用程序的一个基本的组件;

二、TextInput的常见属性

因为TextInput是继承自UIView,所以View的属性TextInput也能够使用,一些样式类的属性在学习的时候可以参照View的相关属性。

  • value (string):文本输入的默认值,不能删除
  • onChangeText (bool):监听用户输入的值:
    React Native 常用组件之 TextInput_第1张图片
  • keyboardType 键盘类型:决定打开哪种键盘,例如,数字键盘。
    enum('default', "ascii-capable", 'numbers-and-punctuation', 'url', 'number-pad', 'phone-pad', 'name-phone-pad', 'email-address', 'decimal-pad', 'twitter', 'web-search', "numeric")
  • multiline (bool):如果值为真,文本输入可以输入多行。默认值为假。
  • password (bool):如果值为真,文本输入框就成为一个密码区域。默认值为假。
  • placeholder (string):在文本输入之前字符串将被呈现出来,通常被称为占位文字
  • placeholderTextColor (string):占位符字符串的文本颜色
  • autoCapitalize:可以通知文本输入自动利用某些字符。enum('none', 'sentences', 'words', 'characters')
  • characters:所有字符,
  • words:每一个单词的首字母
  • sentences:每个句子的首字母(默认情况下)
  • none:不会自动使用任何东西
  • autoCorrect (bool):如果值为假,禁用自动校正。默认值为真。
  • autoFocus (bool):如果值为真,聚焦 componentDidMount 上的文本。默认值为假。
  • bufferDelay (number):会帮助避免由于 JS 和原生文本输入之间的竞态条件而丢失字符。默认值应该是没问题的,但是如果你每一个按键都操作的非常缓慢,那么你可能想尝试增加这个。
  • clearButtonMode:清除按钮出现在文本视图右侧的时机enum('never', 'while-editing', 'unless-editing', 'always')
  • controlled (bool):如果你真想要它表现成一个控制组件,你可以将它的值设置为真,但是按下按键,并且/或者缓慢打字,你可能会看到它闪烁,这取决于你如何处理 onChange 事件。
  • editable (bool):如果值为假,文本是不可编辑的。默认值为真。
  • enablesReturnKeyAutomatically (bool):如果值为真,当没有文本的时候键盘是不能返回键值的,当有文本的时候会自动返回。默认值为假。
  • onBlur (bool):当文本输入是模糊的,调用回调函数
  • onChange (function):当文本输入的文本发生变化时,调用回调函数
  • onEndEditing (function):当文本编辑结束时
  • onFocus (function):当输入的文本是聚焦状态时,调用回调函数
  • returnKeyType:决定返回键的样式 enum('default', 'go', 'google', 'join', 'next', 'route', 'search', 'send', 'yahoo', 'done', 'emergency-call')
  • secureTextEntry (bool):如果值为真,文本输入框就会使输入的文本变得模糊,以便于像密码这样敏感的文本保持安全。默认值为假。

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