Skip to main content
版本：v3+

SMART_KEYBOARD

API_LEVEL 4.0 开始支持，API 兼容性请参考 API_LEVEL。

创建系统级输入键盘，支持多种输入模式。

创建键盘控件​

import { createKeyboard, inputType } from '@zos/ui'

const keyboard = createKeyboard({
  // 必要参数
  inputType: inputType.NUM,
  onComplete: (keyboardWidget, result) => {
    /* 输入完成处理 */
  },
  onCancel: (keyboardWidget, result) => {
    /* 取消输入处理 */
  },

  // 可选参数
  text: '初始文本'
})

类型说明​

Param: object​

属性说明是否必须类型版本
inputType输入类型，参考 inputType 枚举是number4.0
onComplete输入完成回调，用户确认时触发是function4.0
onCancel取消输入回调，右滑或按返回键时触发是function4.0
text初始编辑文本否string4.0
onClick点击事件回调（暂未开放）否function4.0
selection快捷回复选项（暂未开放）否array4.0

inputType 枚举​

值说明
inputType.EMOJIEMOJI 表情
inputType.NUM数字键盘
inputType.CHAR字符键盘
inputType.VOICE语音输入
inputType.SELECT快捷回复选择

方法说明​

deleteKeyboard()​

退出并销毁当前键盘输入界面

import { deleteKeyboard } from '@zos/ui'

deleteKeyboard()

代码示例​

import { createKeyboard, inputType, deleteKeyboard } from '@zos/ui'

Page({
  onInit() {
    this.createKeyboard()
  },

  createKeyboard() {
    createKeyboard({
      inputType: inputType.NUM,
      onComplete: (_, result) => {
        console.log('输入内容:', result.data)
        this.destroyKeyboard()
      },
      onCancel: (_, result) => {
        console.log('取消输入')
        this.destroyKeyboard()
      },
      text: '100' // 初始化文本
    })
  },

  destroyKeyboard() {
    deleteKeyboard()
    // 执行返回页面等后续操作...
  }
})
注意事项
  1. 键盘控件为系统级组件，不支持通过 setProperty 修改属性
  2. 每次页面切换需主动调用 deleteKeyboard 销毁实例
  3. 语音输入功能需要设备硬件支持