react native TextInput组件

TextInput在安卓上默认有一个底边框,同时会有一些padding。如果要想使其看起来和iOS上尽量一致,则需要设置padding: 0

props:

allowFontScaling:控制字体是否要根据系统的“字体大小”辅助选项来进行缩放 布尔 默认true

autoCapitalize:控制TextInput是否要自动将特定字符切换为大写  参数 :none(不切换)、characters(所有字符)、words(每个单词的第一个字符)、sentences(每句话的第一个字符 默认)、这个属性不支持一些keyboard types 比如:name-phone-pad

autoComplete:指定系统的自动完成提示,以便它可以提供自动填充。在Android上,系统将尝试使用启发式方法来识别内容类型,以尝试提供自动填充功能。要禁用自动完成功能,请设置autoComplete为off。安卓参数:('off','username','password','email','name','tel','street-address','postal-code','cc-number','cc-csc', 'cc-exp','cc-exp-month','cc-exp-year')

autoCorrect:如果为false,会关闭拼写自动修正

autoFocus:布尔 聚焦(didmount后)

blurOnSubmit:如果为true,文本框会在提交的时候失焦。注意:对于多行输入框来说,如果将blurOnSubmit设为true,则在点击回车键时就会失去焦点同时触发onSubmitEditing事件,而不会换行。

caretHidden:默认false true时则隐藏光标

clearButtonMode:ios   是否要在文本框右侧显示“清除”按钮。仅在单行模式下使用,参数('never默认', 'while-editing', 'unless-editing', 'always')

clearTextOnFocus:ios 为true,每次开始输入的时候都会清除文本框的内容

contextMenuHidden:为true,菜单会被隐藏

dataDetectorTypes:ios 设置 text input 内能被转化为可点击URL的数据的类型。当且仅当multiline={true}和editable={false}时起作用。

defaultValue:提供一个文本框中的初始值。当用户开始输入的时候,值就可以改变

disableFullscreenUI:安卓 当值为false时, 如果 text input 的周围有少量可用空间的话(比如说,当手机横过来时),操作系统可能会将这个 text input 设置为全屏模式。当值为true时, 这个特性不可用,text input 就是普通的模式。默认为false。

editable:false,文本框是不可编辑的

enablesReturnKeyAutomatically:ios 为true,键盘会在文本框内没有文字的时候禁用确认按钮。默认值为false。

importantForAutofill:安卓

inlineImageLeft:安卓 指定一个图片放置在左侧。图片必须放置在/android/app/src/main/res/drawable目录下,经过编译后按如下形式引用(无路径无后缀)

inlineImagePadding:安卓 

keyboardAppearance:ios 指定键盘的颜色。('default', 'light', 'dark')

keyboardType:决定弹出何种软键盘类型

maxLength:限制文本框中最多的字符数。使用这个属性而不用JS逻辑去实现,可以避免闪烁的现象。

multiline:为true,文本框中可以输入多行文字。注意安卓上如果设置multiline = {true},文本默认会垂直居中,可设置textAlignVertical: 'top'样式来使其居顶显示。

numberOfLines:安卓 设置输入框的行数。当multiline设置为true时使用它,可以占据对应的行数。

onBlur:失去焦点的时候调用此回调函数

onChange:当文本框内容变化时调用此回调函数。回调参数为{ nativeEvent: { eventCount, target, text} }。

onChangeText:一般回调修改state里的值

onContentSizeChange:文本输入的内容大小更改时调用的回调。这将称为{ nativeEvent: { contentSize: { width, height } } }。

onEndEditing:文本输入结束后调用此回调函数

onFocus:当文本框获得焦点的时候调用此回调函数。回调参数为{ nativeEvent: { target } }。

onKeyPress:当一个键被按下的时候调用此回调。传递给回调函数的参数为{ nativeEvent: { key: keyValue } },其中keyValue即为被按下的键。会在onChange之前调用。注意:在Android上只有软键盘会触发此事件,物理键盘不会触发。

onLayout:当组件加载或者布局变化的时候调用,回调参数为{ nativeEvent: {layout: {x, y, width, height}, target } }。

onScroll:在内容滚动时持续调用,传回参数的格式形如{ nativeEvent: { contentOffset: { x, y } } }。也可能包含其他和滚动事件相关的参数,但是在Android上,出于性能考虑,不会提供contentSize参数。

onSelectionChange:长按选择文本时,选择范围变化时调用此函数,传回参数的格式形如{ nativeEvent: { selection: { start, end } } }。需要设置multiline={true}。

onSubmitEditing:此回调函数当软键盘的确定/提交按钮被按下的时候调用此函数,所传参数为{nativeEvent: {text, eventCount, target}}。如果multiline={true},此属性不可用。

onTextInput:使用参数在新文本输入上调用的回调{ nativeEvent: { text, previousText, range: { start, end } } }。该道具需要multiline={true}设置。

placeholder:

placeholderTextColor:占位字符串显示的文字颜色。

returnKeyLabel:安卓 将返回键设置为标签。使用它代替returnKeyType。

returnKeyType:

rejectResponderTermination:确定返回键的外观。在Android上,您也可以使用returnKeyLabel。

仅iOS

如果为true,则允许TextInput将触摸事件传递给父组件。这样就可以从iOS上的TextInput上滑动诸如SwipeableListView之类的组件,就像默认情况下在Android上一样。

scrollEnabled:ios 为false,则将禁用文本视图的滚动。默认值为true。仅适用于multiline={true}。

secureTextEntry:为true,文本框会遮住之前输入的文字,这样类似密码之类的敏感文字可以更加安全。默认值为false。multiline={true}时不可用。

selection:设置选中文字的范围(指定首尾的索引值)。如果首尾为同一索引位置,则相当于指定光标的位置。object: {start: number,end: number}

selectionColor:设置输入框高亮时的颜色(还包括光标)。

selectionState:ios 可以控制一个文档中哪段文字被选中的状态。

selectTextOnFocus:如果为true,当获得焦点的时候,所有的文字都会被选中。

spellCheck:如果设置为false,则禁用拼写检查的样式(比如错误拼写的单词下的红线)。默认值继承自autoCorrect。

textContentType:为键盘和系统提供有关用户输入内容的预期语义的信息。

style:

textBreakStrategy:安卓 在 Android API Level 23+ 的平台上设置文字断行策略, 可能值有simple, highQuality, balanced。默认值为simple。

underlineColorAndroid:安卓 文本框的下划线颜色(译注:如果要去掉文本框的边框,请将此属性设为透明transparent)。

value:文本框中的文字内容。 TextInput是一个受约束的(Controlled)的组件,意味着如果提供了value属性,原生值会被强制与value属性保持一致。在大部分情况下这都工作的很好,不过有些情况下会导致一些闪烁现象——一个常见的原因就是通过不改变value来阻止用户进行编辑。如果你希望阻止用户输入,可以考虑设置editable={false};如果你是希望限制输入的长度,可以考虑设置maxLength属性,这两个属性都不会导致闪烁。




方法:

.focus()

.blur()

clear()

isFocused()

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,607评论 6 507
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,239评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,960评论 0 355
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,750评论 1 294
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,764评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,604评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,347评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,253评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,702评论 1 315
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,893评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,015评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,734评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,352评论 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,934评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,052评论 1 270
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,216评论 3 371
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,969评论 2 355

推荐阅读更多精彩内容