属性名
取值
说明
autoCapitalize
enum(‘none', ‘sentences', ‘words', ‘characters')
设置英文字母自动大写规则,取值分别表示:不自动大写、每句话首字母自动大写、每个单词首字母大写、全部字母自动大写
autoCorrect
bool
是否会自动检测用户输入的英语单词正确性,默认值为true
autoFocus
bool
如果为true,在componentDidMount后会获得焦点。默认值为false。
defaultValue
string
字符初始值,当用户开始输入时,该值将改变
placeholder
node
文本输入之前将呈现的字符串,多用于提示用户应该输入什么
placeholderTextColor
color
文本输入之前将呈现的字符串的颜色
editable
bool
是否允许修改字符,默认值为true
maxLength
number
最多允许用户输入多少字符
caretHidden
bool
如果为true,则隐藏光标
multiline
bool
如果为true,则文本输入可以是多行的,默认值为false
secureTextEntry
bool
文本框是否用于输入密码,默认值为false
selectTextOnFocus
bool
如果为true,则文本框获取焦点时,组件中的内容会被自动选中
onFocus
function
当文本框获得焦点的时候调用此回调函数
onEndEditing
function
当文本输入结束后调用此回调函数
onLayout
function
当组件挂载或者布局变化的时候调用,参数为{x, y, width, height}
onScroll
function
在内容滚动时持续调用,传回参数的格式形如{ nativeEvent: { contentOffset: { x, y } } }
onSelectionChange
function
长按选择文本时,选择范围变化时调用此函数,传回参数的格式形如 { nativeEvent: { selection: { start, end } } }
value
string
文本框中的文字内容
2.8 Android平台独有属性
属性名
取值
说明
inlineImageLeft
string
指定一个图片放置在左侧
inlineImagePadding
number
左侧图片的Padding(如果有的话),以及文本框本身的Padding
numberOfLines
number
TextInput的行数
underlineColorAndroid
string
TextInput的下划线颜色
returnKeyLabel
string
设置软键盘回车键的内容,优先级高于returnKeyType
disableFullscreenUI
bool
值为false时(默认值),如果TextInput的输入空间小,系统可能会进入全屏文本输入模式
2.9 iOS平台独有属性