基础信息说明

功能概述：提供软键盘的显示、隐藏、输入以及相关事件的监听能力。

方法说明

参数说明

qg.showKeyboard(Object option)

confirmType 的合法值

qg.onKeyboardInput(Function callback)

回调函数 callback(Object res)

qg.onKeyboardConfirm(Function callback)

回调函数 callback(Object res)

qg.onKeyboardComplete(Function callback)

qg.offKeyboardInput(Function callback)

qg.offKeyboardConfirm(Function callback)

qg.offKeyboardComplete(Function callback)

qg.hideKeyboard(Object option)

qg.updateKeyboard(Object option)

回调结果说明

示例代码

// 显示与隐藏
qg.showKeyboard({
  defaultValue: 'defaultValue',
  maxLength: 20,
  multiple: false,
  confirmHold: false,
  confirmType: 'done',
  success: function (res) {
    console.info('showKeyboard success', res)；
  },
  fail: function () {
    console.info('showKeyboard fail')；
  },
  complete: function () {
    console.info('showKeyboard complete')；
  },
})；
qg.hideKeyboard({
  success: function () {
    console.info('hideKeyboard success')；
  },
  fail: function () {
    console.info('hideKeyboard fail')；
  },
  complete: function () {
    console.info('hideKeyboard complete')；
  },
})

// 监听键盘输入
function getInputValue(res) {
  console.log('keyboard input:', res.value);
}

qg.onKeyboardInput(getInputValue);
qg.offKeyboardInput(getInputValue);

// 监听用户点击键盘 Confirm 按钮
function getConfirmValue(res) {
  console.log('keyboard confirm:', res.value);
}

qg.onKeyboardConfirm(getConfirmValue);
qg.offKeyboardConfirm(getConfirmValue);

// 监听键盘收起
function getCompleteValue(res) {
  console.log('keyboard complete:', res.value);
}

qg.onKeyboardComplete(getCompleteValue);
qg.offKeyboardComplete(getCompleteValue);

// 更新键盘输入值
qg.updateKeyboard({
  value: 'a',
  success: function () {
    console.info('updateKeyboard success')；
  },
  fail: function () {
    console.info('updateKeyboard fail')；
  },
  complete: function () {
    console.info('updateKeyboard complete')；
  },
})

注意事项

• qg.updateKeyboard方法更新键盘输入框内容，只有当键盘处于拉起状态时才会产生效果