更新记录

1.0.0（2025-02-11） 下载此版本

首次上传

平台兼容性

u-pointer

介绍

消除 uni 中组件事件触发的各端异性, 统一事件处理, 减轻负担

u-pointer

事件

类型

使用方法

<template>
    <u-pointer
        @onpointerclick="pointerclick"
        @onpointerdown="pointerdown"
        @onpointermove="pointermove"
        @onpointerup="pointerup"
        @onpointerwheel="pointerwheel"
    >
        <view>Click Me</view>
    </u-pointer>
</template>

u-pointer-root

事件

此组件一般放在 根节点 下, 组件上无任何事件 但有一个 globalPointer 的全局指针监听器, 回调类型与 u-pointer 事件保持一致.

使用方法类似于 document.addEventListener, 只不过需要换成 globalPointer.addEventListener 来监听事件.

使用方法

u-pointer-root

<script lang="ts" setup>
import { onMounted, onUnmounted } from "vue";
import { PointerdownEvent, globalPointer } from "@/uni_modules/u-pointer";
function pointerdown(event: PointerdownEvent): void {
    console.log("pointerdown", event);
}

onMounted(() => {
    globalPointer.addEventListener("", pointerdown);
});

onUnmounted(() => {
    globalPointer.removeEventListener("", pointerdown);
});
</script>

<template>
    <u-pointer-root>
        <view>Click Me</view>
    </u-pointer-root>
</template>

注意事项

1. @onpointerclick 事件在按下后 移动指针 或 按下超过 300ms 不会触发.
2. @onpointerup 事件触发后会立即触发 @onpointerclick . 此处是已知问题, 但不会影响使用, 只是触发队列不一致, 后面反馈的人多了或有空的话会补上.

TODO

1. [ ] @onpointerdbclick 双击事件
2. [ ] @onpointerlongclick 长按事件
3. [ ] stopPropagation 阻止当前事件的进一步传播
4. [ ] preventDefault 阻止当前事件的默认行为