26、鸿蒙/组件/输入框(TextInput、TextArea)

TextInput、TextArea是输入框组件，通常用于响应用户的输入操作，比如评论区的输入、聊天框的输入、表格的输入等，也可以结合其它组件构建功能页面，例如登录注册页面。具体用法请参考TextInput、TextArea。

创建输入框

TextInput为单行输入框、TextArea为多行输入框。通过以下接口来创建。

TextInput(value?:{placeholder?: ResourceStr, text?: ResourceStr, controller?: TextInputController})

TextArea(value?:{placeholder?: ResourceStr, text?: ResourceStr, controller?: TextAreaController})

• 单行输入框

TextInput()

• 多行输入框

TextArea()

多行输入框文字超出一行时会自动折行。

@State textval: string = '文本域输入框文本域输入框文本域输入框文本域输入框'
// ...
TextArea({text: this.textval}).width(200)

设置输入框类型

TextInput有9种可选类型，分别为Normal基本输入模式、Password密码输入模式、Email邮箱地址输入模式、Number纯数字输入模式、PhoneNumber电话号码输入模式、USER_NAME用户名输入模式、NEW_PASSWORD新密码输入模式、NUMBER_PASSWORD纯数字密码输入模式、NUMBER_DECIMAL带小数点的数字输入模式。通过type属性进行设置：

• 基本输入模式（默认类型）

TextInput().type(InputType.Normal)

• 密码输入模式

TextInput().type(InputType.Password)

• 手机号模式

 TextInput().type(InputType.PhoneNumber)

自定义样式

• 设置无输入时的提示文本。

TextInput({ placeholder: '请输入' })

• 设置输入框当前的文本内容。

TextInput({ placeholder: '请输入', text: '默认值' })

• 添加backgroundColor改变输入框的背景颜色。

TextInput().backgroundColor(Color.Pink)

添加事件

文本框主要用于获取用户输入的信息，把信息处理成数据进行上传，绑定onChange事件可以获取输入框内改变的内容。用户也可以使用通用事件来进行相应的交互操作。

TextInput().onChange((val: string)=>{
          console.log('输入的值:', val)
}).onFocus(()=>{
        console.log('获取焦点:')
})

键盘避让

键盘抬起后，具有滚动能力的容器组件在横竖屏切换时，才会生效键盘避让，若希望无滚动能力的容器组件也生效键盘避让，建议在组件外嵌套一层具有滚动能力的容器组件，比如Scroll、List、Grid。

Scroll() {
  Column(){
     TextInput()
     TextInput()
     TextInput()
     TextInput()
  }
}