liko
    Preparing search index...

    Class LikoPointerEvent

    指针事件类,用于处理鼠标和触摸事件

    出于性能考虑,事件对象是复用的,每个事件类型(如 pointerup、click 等)共用一个事件实例 如果需要延迟读取事件内容,请使用 clone 方法复制一个新的事件对象

    // 在节点上监听指针事件
    node.on('click', (event: LikoPointerEvent) => {
    console.log('点击位置:', event.pointer.x, event.pointer.y);
    console.log('目标节点:', event.target);

    // 阻止事件冒泡
    event.stopPropagation();

    // 阻止默认行为
    event.preventDefault();
    });

    // 复制事件对象用于延迟处理
    let savedEvent: LikoPointerEvent;
    node.on('pointerdown', (event: LikoPointerEvent) => {
    savedEvent = event.clone();
    setTimeout(() => {
    console.log('延迟处理事件:', savedEvent.type);
    }, 1000);
    });
    Index

    Constructors

    Properties

    altKey: boolean = false

    指示 Alt 键是否被按下

    在事件触发时检测修饰键状态

    button: number = 0

    触发事件的指针按键

    0 - 左键,1 - 中键,2 - 右键

    ctrlKey: boolean = false

    指示 Ctrl 键是否被按下

    在事件触发时检测修饰键状态

    currentTarget: LikoNode

    当前正在处理事件的节点

    在事件冒泡过程中,此属性会随着事件传播而变化,指向当前正在处理事件的节点

    detail: number = 0

    事件的详细信息

    对于 click 事件表示点击次数(单击为1,双击为2等)

    movement: { x: number; y: number } = ...

    指针移动的相对位移

    仅在 pointermove 事件中有意义,表示自上次事件以来指针的移动距离

    nativeEvent: PointerEvent

    原始的浏览器 PointerEvent 对象

    可以通过此属性访问原始的浏览器事件对象,获取更多详细信息

    path: LikoNode[] = []

    事件的冒泡路径

    包含从目标节点到根节点的完整路径,用于事件传播

    pointer: { x: number; y: number } = ...

    相对于 stage 的指针坐标

    坐标原点为 stage 的左上角,单位为像素

    preventDefaulted: boolean = false

    标识事件的默认行为是否已被阻止

    当调用 preventDefault() 方法后,此属性将被设置为 true

    propagationStopped: boolean = false

    标识事件是否已停止传播

    当调用 stopPropagation() 方法后,此属性将被设置为 true

    shiftKey: boolean = false

    指示 Shift 键是否被按下

    在事件触发时检测修饰键状态

    target: LikoNode

    触发事件的目标节点

    始终指向最初触发事件的节点,即使在事件冒泡过程中也不会改变

    type: PointerEventType

    指针事件类型

    Methods

    • 创建当前事件对象的副本

      Returns LikoPointerEvent

      新的事件对象副本

      • 由于事件对象是复用的,如果需要延迟处理事件数据,必须使用此方法创建副本
      • 返回的副本包含当前事件的所有属性值
    • 阻止事件的默认行为

      Returns void

      • 如果在 pointerup 事件中调用,将会阻止后续 click 事件的派发
      • 在 passive 事件监听器中调用可能无效
    • 停止事件在节点树中的进一步冒泡传播

      Returns void

      调用此方法后,事件将不会继续向父节点传播