input

[范例：demo-input.vue]

单行文本组件。

不建议手工双向绑定数据，建议通过 v-model 来绑定视图和数据。

属性

参数	描述	类型
defaultValue	提供一个文本框中的初始值。当用户开始输入的时候，值就可以改变。 在一些简单的使用情形下，如果你不想用监听消息然后更新 value 属性的方法来保持属性和状态同步的时候，就可以用 defaultValue 来代替。	string
editable	如果为 false，文本框是不可编辑的。default: true	boolean
type	决定弹出的何种软键盘的。 注意，password仅在属性 multiline=false 单行文本框时生效。	enum(default, numeric, password, email, phone-pad)
maxlength	限制文本框中最多的字符数。使用这个属性而不用JS 逻辑去实现，可以避免闪烁的现象。	numbers
numberOfLines	设置 input 的最大行数，在使用的时候必需同时设置 multiline 参数为 true。	number
placeholder	如果没有任何文字输入，会显示此字符串。	string
placeholderTextColor	占位字符串显示的文字颜色。	color
returnKeyType	指定软键盘的回车键显示的样式。	enum(done, go, next, search, send)
value	指定 input 组件的值。	string

方法

blur

() => void 让指定的 input 组件失去光标焦点，与 focus() 的作用相反。

clear

() => void 清空输入框的内容。

focus

() => void 指派 input 获得焦点。

getValue

() => Promise<string> 获得文本框中的内容。

setValue

(value: string) => void 设置文本框内容。

• value: string - 文本框内容

---

事件

事件名称	描述	类型	支持平台
blur	当文本框失去焦点的时候调用此回调函数。	Function	ALL
change	当文本框内容变化时调用此回调函数。改变后的文字内容会作为参数传递。	Function	ALL
keyboardWillShow	在弹出输入法键盘时候会触发此回调函数，返回值包含键盘高度 keyboardHeight，样式如 { keyboardHeight: 260}。	Function	ALL
keyboardWillHide	在隐藏输入法键盘时候会触发此回调函数	Function	ALL
keyboardHeightChanged	在输入法键盘高度改变时触发此回调函数，返回值包含键盘高度 keyboardHeight，样式如 { keyboardHeight: 260 }。	Function	ALL
endEditing	当文本输入结束后调用此回调函数。	Function	ALL
layout	当组件挂载或者布局变化的时候调用，参数为{ x, y, width, height }。	Function	ALL
selectionChange	当输入框选择文字的范围被改变时调用。返回参数的样式如 { nativeEvent: { selection: { start, end } } }。	Function	ALL