Weex 内置的 <input>
组件用来创建接收用户输入字符的输入组件。 <input>
组件的工作方式因 type
属性的值而异,比如 text
, password
,url
,email
,tel
等。
::: warning 注意 此组件不支持 click
事件。请监听 input
或 change
来代替 click
事件。 :::
<input>
不支持子组件。
key | 类型 | 描述 | 默认值 | 备注 |
---|---|---|---|---|
type | string | 控件的类型 | text | type 值可以是 text,date,datetime,email, password,tel,time,url,number 。每个 type 值都符合 W3C 标准。 其中,date 和 time 会使用系统默认组件(Android + IOS)查看示例 |
value | string | 组件的默认内容 | ||
placeholder | string | 提示用户可以输入什么。 提示文本不能有回车或换行 | ||
autofocus | boolean | 布尔类型的数据,表示是否在页面加载时控件自动获得输入焦点 | ||
maxlength | nubmer | 一个数值类型的值,表示输入的最大长度 | ||
return-key-type | string | 键盘返回键的类型(即手机输入法右下角回车按钮的地方) | 支持 defalut;go;next;search;send,done 查看示例 | |
singleline | boolean | 控制内容是否只允许单行 | true | |
max | string | 控制当 type 属性为 date 时选择日期的最大时间,格式为 yyyy-MM-dd | ||
min | string | 控制当 type 属性为 date 时选择日期的最小时间,格式为 yyyy-MM-dd | ||
upriseOffset | number | 当键盘弹起可能盖住输入框时,页面整体会上移。这个属性指定键盘上边缘与输入框下边缘的间隙。使用 iOS 系统坐标,默认是 20。 | 20 | |
hideDoneButton | number | 隐藏键盘上面的完成栏 | false |
placeholder 字符颜色。默认值是 #999999
支持:
:active
:focus
:disabled
:enabled
支持所有通用样式
flexbox
布局position
opacity
background-color
查看 组件通用样式
将 input
组件聚焦。
从 input
组件中移除焦点并关闭软键盘(如果它具有焦点)。
设置文本选区
key | 类型 | 描述 |
---|---|---|
selectionStart | number | 设置文本选区的起始点 |
selectionEnd | number | 设置文本选区的起终点 |
获取文本选区
key | 类型 | 描述 |
---|---|---|
params.selectionStart | number | 文本选区的起始点 |
params.selectionEnd | number | 文本选区的起终点 |
这是一个非常有用的特性,可以对 input 设置一组对输入的内容进行实时格式化的规则
key | 类型 | 描述 |
---|---|---|
params.formatRule | regexp | 格式化匹配的正则表达式 |
params.formatReplace | regexp | 格式化匹配后用于替换的内容 |
params.recoverRule | regexp | 从格式化后的内容还原原始内容的正则表达式 |
params.recoverReplace | regexp | 还原原始内容时用于替换的内容 |
::: warning 约束 目前不支持 this.$el(id).value = '' 这种方式改写 input value。只支持在 <input>
组件的 input、change 事件中改写。 :::
rax-textinput
是 <textarea>
组件的上层封装,抹平了 Web 和 Weex 的展现
import { createElement, render } from "rax"; import Driver from 'driver-universal'; import TextInput from "rax-textinput"; function App() { return ( <TextInput autoFocus={true} /> ); } render(<App />, document.body, { driver: Driver });