uniapp事件修饰符和事件映射名称

事件修饰符

修饰符 (modifier) 是以半角句号 . 指明的特殊后缀，用于指出一个指令应该以特殊方式绑定。例如，.prevent 修饰符告诉 @事件对于触发的事件调用 event.preventDefault()：

@事件（v-on）提供了事件修饰符:

• .stop: 各平台均支持， 使用时会阻止事件冒泡，在非 H5 端同时也会阻止事件的默认行为
• .native: 监听原生事件，各平台均支持
• .prevent: 仅在 H5 平台支持
• .capture: 仅在 H5 平台支持
• .self: 仅在 H5 平台支持
• .once: 仅在 H5 平台支持
• .passive: 仅在 H5 平台支持

使用修饰符时，顺序很重要；相应的代码会以同样的顺序产生。因此，用 @click.prevent.self 会阻止所有的点击，而 @click.self.prevent 只会阻止对元素自身的点击。

注意

• 为兼容各端，事件需使用 @ 的方式绑定，请勿使用小程序端的 bind 和 catch 进行事件绑定；也不能在 JS 中使用event.preventDefault()和event.stopPropagation()方法；
• 若需要禁止蒙版下的页面滚动，可使用 @touchmove.stop.prevent="moveHandle"，moveHandle 可以用来处理 touchmove 的事件，也可以是一个空函数。

• 按键修饰符：uni-app 运行在手机端，没有键盘事件，所以不支持按键修饰符。
• 以下几个也是支持的

• 鼠标事件类型
  事件类型	说明
  click	单击鼠标左键时发生，如果右键也按下则不会发生。当用户的焦点在按钮上并按了 Enter 键时，同样会触发这个事件
  dblclick	双击鼠标左键时发生，如果右键也按下则不会发生
  mousedown	单击任意一个鼠标按钮时发生
  mouseout	鼠标指针位于某个元素上且将要移出元素的边界时发生
  mouseover	鼠标指针移出某个元素到另一个元素上时发生
  mouseup	松开任意一个鼠标按钮时发生
  mousemove	鼠标在某个元素上时持续发生

事件映射表

// 事件映射表，左侧为 WEB 事件，右侧为 ``uni-app`` 对应事件
    {
        click: 'tap',
        touchstart: 'touchstart',
        touchmove: 'touchmove',
        touchcancel: 'touchcancel',
        touchend: 'touchend',
        tap: 'tap',
        longtap: 'longtap', //推荐使用longpress代替
        input: 'input',
        change: 'change',
        submit: 'submit',
        blur: 'blur',
        focus: 'focus',
        reset: 'reset',
        /confirm/i: '/confirm/i',
        columnchange: 'columnchange',
        linechange: 'linechange',
        error: 'error',
        scrolltoupper: 'scrolltoupper',
        scrolltolower: 'scrolltolower',
        scroll: 'scroll'
    }