抖音开放平台Logo
控制台

tt.onKeyboardInput
收藏
我的收藏

基础库 1.0.0 开始支持本方法,这是一个同步方法。

监听键盘输入事件。

前提条件
业务背景
使用限制
注意事项
  • 请在用户完整输入信息后(比如昵称起名环节),使用 tt.onKeyboardConfirm 或者tt.onKeyboardComplete 接口来获取用户输入的信息,此时的信息经过平台敏感词检测,能够确保业务安全。仅使用 tt.onKeyboardInput 逐字获取输入信息,会导致敏感词检测的逻辑无法触发。
相关教程

语法

tt.onKeyboardInput(handler)

参数说明

handler

类型默认值必填说明最低支持版本
function

监听键盘输入事件的回调函数

1.0.0

handler 是一个回调函数,接收 object 类型的参数,属性如下:

属性名类型说明最低支持版本
valuestring

键盘输入的当前值

1.0.0

返回值

代码示例

tt.onKeyboardInput(data => {
  console.log('键盘输入的当前值', data.value);
})