nav: path: /components group: title: 信息输入 order: 10

toc: content

Input 输入框

通过键盘输入内容，是最基础的表单域包装。

何时使用

一般用在表单页进行信息的收集。

代码示例

Input 基本使用

SearchBar 搜索框

Textarea

自定义

API

Input、Textarea 相同的属性

属性	说明	类型	默认值
className	类名	string	-
controlled	有键盘输入问题，可使用 `controlled="{{false}}"`	boolean	-
defaultValue	初始值	string	-
disabled	是否禁用	boolean	false
maxLength	最大长度	number	140
placeholder	占位符	string	-
style	样式	string	-
value	输入框的值。受控模式。	string	-
onConfirm	点击键盘完成时触发此回调	(value: string, event: Event) => void	-
onFocus	聚焦时触发此回调	(value: string, event: Event) => void	-
onBlur	失焦时触发此回调	(value: string, event: Event) => void	-
onChange	输入时触发此回调	(value: string, event: Event) => void	-

Input 属性

属性	说明	类型	默认值
allowClear	可以点击清除图标删除内容	boolean	false
enableNative	是否使用 native	boolean	-
focus	聚焦，查看详细说明	boolean	-
password	是否是密码类型	boolean	false
prefix	input 前缀	slot	-
suffix	input 后缀	slot	-

Textarea 属性

属性	说明	类型	默认值
autoHeight	是否自动增高。	boolean	false
enableNative	是否使用 native	boolean	-
showCount	是否显示字数统计	boolean	true

Input、Textarea 更多相同属性

confirm-type
name
placeholder-class
placeholder-style
type

Input
Textarea

Input focus

使用 focus 属性需要在 app.json window 里加上 "enableInPageRenderInput": "YES"，否则无法在 iOS 里打开键盘。

Input、Textarea 实例方法

实例方法需要小程序 component2 可使用。

属性	说明	类型
update	更新值	(value: string) => void
getValue	得到值	() => string

FAQ

Input focus 没有打开键盘

需要在 app.json window 里加上 "enableInPageRenderInput": "YES"。

Input 出现光标问题

可查看此文档使用 enableNative 属性解决。

使用 value 受控模式出现键盘问题

这个是由于输入框的一个已知问题。

解决方式为：不使用 value 受控模式，采用 ref 方式调用 input 更新方法。

<input defaultValue="{{defaultValue}}" ref="handleRef" />
<button onTap="clear">clear</button>

Page({
  handleRef(input) {
    this.input = input;
  },
  clear() {
    this.input.update('');
  },
});

从 v2.15.0 开始，受控模式下，不支持通过 update 方法更新值。

实例方法不可用

需要使用 component2，详情参见ref 获取组件实例。

index.md 3.6 KB Histórico Raw