TextInput (系统接口)

单行文本输入框组件。

说明：

该组件从API version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

当前页面仅包含本模块的系统接口，其他公开接口参见TextInput。

InputType枚举说明

单行文本输入框类型。

系统能力： SystemCapability.ArkUI.ArkUI.Full

名称	值	说明
SCREEN_LOCK_PASSWORD¹¹⁺	9	锁屏应用密码输入模式。支持输入数字、字母、下划线、空格、特殊字符。密码显示小眼睛图标并且默认会将文字变成圆点，从API version 12开始，特定设备上输入文字直接显示为圆点。密码输入模式不支持下划线样式。系统接口：此接口为系统接口。模型约束：此接口仅可在Stage模型下使用。

voiceButton(options: Optional<VoiceButtonOptions>)

设置语音按钮选项。

系统接口： 此接口为系统接口。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

原子化服务API： 从API version 23开始，该接口支持在原子化服务中使用。

参数：

参数名	类型	必填	说明
options	Optional<VoiceButtonOptions>	是	语音按钮选项参数。

该示例通过配置voiceButton接口，为输入框启用语音输入按钮。

从API version 23开始，新增voiceButton接口。

// xxx.ets
@Entry
@Component
struct TextInputExample {

  build() {
    Column() {
      TextInput().voiceButton({enabled: true})
    }
  }
}