Vue 常用修饰符

时间:2024-04-25 07:18:04

目录

定义

事件修饰符 v-on(缩写@)

鼠标按键修饰符

v-bind 修饰符(缩写:)

键值修饰符

表单修饰符


定义

修饰符是用于限定类型以及类型成员的声明的一种符号,vue 中修饰符分为以下五种:事件修饰符、鼠标按键修饰符、v-bind 修饰符、键值修饰符、表单修饰符

事件修饰符 v-on(缩写@)

  • .stop:阻止事件冒泡,相当于调用 event.stopPropagation() 方法

  • .prevent:阻止事件的默认行为,相当于调用 event.preventDefault() 方法

  • .capture:使事件触发从包含这个元素的顶层开始往下触发

    <div @click.capture="shout(1)">
        obj1
        <div @click.capture="shout(2)">
            obj2
            <div @click="shout(3)">
                obj3
                <div @click="shout(4)">
                    obj4
                </div>
            </div>
        </div>
    </div>
    // 输出结构:1 2 4 3
  • .self:只当在 event.target 是当前元素自身时触发处理函数

  • .native:让组件变成像 html 内置标签那样监听根元素的原生事件,否则组件上使用 v-on 只会监听自定义事件

  • .once:绑定了事件以后只能触发一次,第二次就不会触发

  • .passive:在移动端,当我们在监听元素滚动事件的时候,会一直触发 onscroll 事件会让我们的网页变卡,因此我们使用这个修饰符的时候,相当于给 onscroll 事件整了一个 .lazy 修饰符

    <!-- 滚动事件的默认行为 (即滚动行为) 将会立即触发 -->
    <!-- 而不会等待 `onScroll` 完成  -->
    <!-- 这其中包含 `event.preventDefault()` 的情况 -->
    <div v-on:scroll.passive="onScroll">...</div>

❗️❗️ 注意:

不要把 .passive 和 .prevent 一起使用,因为 .prevent 将会被忽略,同时浏览器可能会向你展示一个警告。请记住,.passive 会告诉浏览器你不想阻止事件的默认行为。

鼠标按键修饰符

  • .left:只当点击鼠标左键时触发

  • .right:只当点击鼠标右键时触发

  • .middle:只当点击鼠标中键时触发

v-bind 修饰符(缩写:)

  • .prop:设置自定义标签属性,避免暴露数据,防止污染HTML结构

  • .camel:将命名变为驼峰命名法,如将 view-Box属性名转换为 viewBox

  • .sync:语法糖,能对 props 进行一个双向绑定

键值修饰符

在监听键盘事件时,我们经常需要检查详细的按键。Vue 允许为 v-on 在监听键盘事件时添加按键修饰符:

@keyup:按键抬起

@keydown:按键按下

  • .enter:只有在 `key` 是 `Enter` 时调用
    <input v-on:keyup.enter="submit">
  • .tab:捕获 tab 键
  • .delete:捕获 delete 删除键和 backspace 退格键
  • .esc
  • .space
  • .up
  • .down
  • .left
  • .right
  • .ctrl
  • .alt
  • .shift
  • .exact 修饰符允许你控制由精确的系统修饰符组合触发的事件
    <!-- 即使 Alt 或 Shift 被一同按下时也会触发 -->
    <button v-on:click.ctrl="onClick">A</button>
    
    <!-- 有且只有 Ctrl 被按下的时候才触发 -->
    <button v-on:click.ctrl.exact="onCtrlClick">A</button>
    
    <!-- 没有任何系统修饰符被按下的时候才触发 -->
    <button v-on:click.exact="onClick">A</button>
  • .meta

❗️❗️ 注意:

  • 在 Mac 系统键盘上,meta 对应 command 键 (⌘)。
  • 在 Windows 系统键盘 meta 对应 Windows 徽标键 (⊞)。
  • 在 Sun 操作系统键盘上,meta 对应实心宝石键 (◆)。
  • 在其他特定键盘上,尤其在 MIT 和 Lisp 机器的键盘、以及其后继产品,比如 Knight 键盘、space-cadet 键盘,meta 被标记为“META”。
  • 在 Symbolics 键盘上,meta 被标记为“META”或者“Meta”。

使用 keyCode attribute 也是允许的:

<!-- 回车键 -->
<input v-on:keyup.13="submit">

<!-- Alt + C -->
<input v-on:keyup.alt.67="clear">

<!-- Ctrl + Click -->
<div v-on:click.ctrl="doSomething">Do something</div>

还可以通过全局 config.keyCodes 对象自定义按键修饰符别名

// 可以使用 `v-on:keyup.f1`
Vue.config.keyCodes.f1 = 112

表单修饰符

  • .lazy:在表单输入时不会马上显示在页面,而是等输入完成失去焦点时才会显示,也就是在change 事件之后再进行信息同步
    <input type="text" v-model.lazy="value">
    <p>{{value}}</p>
  • .trim:过滤表单输入时两边的空格,而中间的空格不会过滤
    <input type="text" v-model.trim="value"></input>
  • .number:自动将用户的输入值转为数值类型,但如果这个值无法被 parseFloat 解析,则会返回原来的值
    <input type="number" v-model.number="age"></input>