tt.onWheel
收藏我的收藏
收藏基础库 3.54.0 开始支持本方法，这是一个同步方法。
监听鼠标滚轮事件，仅适用于 PC 平台
| 前提条件 | 无 |
| 业务背景 | 无 |
| 使用限制 | 只支持 PC 端使用该能力 |
| 注意事项 | 无 |
| 相关教程 |
语法
tt.onWheel(handler)
参数说明
handler
| 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
|---|---|---|---|---|
| function | 是 | 传入的事件回调函数 | 3.54.0 |
handler 是一个回调函数，接收 object 类型的参数，属性如下：
| 属性名 | 类型 | 说明 | 最低支持版本 |
|---|---|---|---|
| deltaX | number | 滚轮 x 轴方向滚动量 | 3.54.0 |
| deltaY | number | 滚轮 y 轴方向滚动量 | 3.54.0 |
| deltaZ | number | 滚轮 z 轴方向滚动量 | 3.54.0 |
| x | number | 事件触发时鼠标所在的位置横坐标 | 3.54.0 |
| y | number | 事件触发时鼠标所在的位置纵坐标 | 3.54.0 |
| timeStamp | number | 事件触发的高精度时间戳 | 3.54.0 |
返回值
无
错误码
| errorCode | errMsg | errorType | 说明 | 最低支持版本 |
|---|---|---|---|---|
| 999999 | invalid param | D | 参数错误 | 3.54.0 |
| 999988 | The feature is not available in current operating system | D | 不支持该系统，只支持在 PC 端调用 | 3.54.0 |
扫码体验
请使用字节宿主APP扫码
代码示例
tt.onWheel((e) => { tt.showToast({ title: `Wheel x: ${e.deltaX} y: ${e.deltaY}`, }); })
