# uni.hideKeyboard()

隐藏软键盘

隐藏已经显示的软键盘,如果软键盘没有显示则不做任何操作。

平台差异说明

App H5 微信小程序 支付宝小程序 百度小程序 抖音小程序、飞书小程序 QQ小程序 快手小程序 京东小程序
x

HarmonyOS Next 兼容性

HarmonyOS Next
HBuilderX 4.23

# uni.onKeyboardHeightChange(CALLBACK)

监听键盘高度变化

平台差异说明

App HarmonyOS Next H5 微信小程序 支付宝小程序 百度小程序 抖音小程序、飞书小程序 QQ小程序 快手小程序 京东小程序
HBuilderX 2.2.3+ HBuilderX 4.23 基础库2.7+ HBuilderX 3.6.8+ x x

参数

function listener

键盘高度变化事件的监听函数

参数

Object res

参数 类型 说明
height Number 键盘高度

示例代码

uni.onKeyboardHeightChange(res => {
  console.log(res.height)
})

# uni.offKeyboardHeightChange(CALLBACK)

取消监听键盘高度变化事件

平台差异说明

App HarmonyOS Next H5 微信小程序 支付宝小程序 百度小程序 抖音小程序、飞书小程序 QQ小程序 快手小程序 京东小程序
HBuilderX 3.1.0+ HBuilderX 4.23 x 基础库2.9.2+ HBuilderX 3.6.8+ x x x x

参数

function listener

onKeyboardHeightChange 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function (res) { console.log(res) }

uni.onKeyboardHeightChange(listener)
uni.offKeyboardHeightChange(listener) // 需传入与监听时同一个的函数对象

# uni.getSelectedTextRange(OBJECT)

在input、textarea等focus之后,获取输入框的光标位置。注意:只有在focus的时候调用此接口才有效。目前仅支持 vue 页面,nvue 可以直接使用 weex 的 getSelectionRange

平台差异说明

App HarmonyOS Next H5 微信小程序 支付宝小程序 百度小程序 抖音小程序、飞书小程序 QQ小程序 快手小程序 京东小程序
HBuilderX 2.8.12+ x HBuilderX 2.8.12+ 基础库 2.7.0+ x x x x x

OBJECT 参数说明:

参数名 类型 默认值 必填 说明
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

success 返回参数说明:

属性 类型 说明
start Number 输入框光标起始位置
end Number 输入框光标结束位置

示例代码

uni.getSelectedTextRange({
  success: res => {
    console.log('getSelectedTextRange res', res.start, res.end)
  }
})