Skip to content

vue2.0 常见的修饰符

提示

在程序世界里,修饰符是用于限定类型以及类型成员的声明的一种符号。

vue 中,修饰符处理了许多 DOM 事件的细节,让我们不再需要花大量的时间去处理这些烦恼的事情,而能有更多的精力专注于程序的逻辑处理。

md
vue 中修饰符分为以下五种:

1. 表单修饰符
2. 事件修饰符
3. 鼠标按键修饰符
4. 键盘值修饰符
5. v-bind 修饰符

一、表单修饰符

在我们填写表单的时候用得最多的是 input 标签,指令用得最多的是 v-model

md
关于表单的修饰符有:

1. lazy
2. trim
3. number
  1. lazy 在我们填完信息,光标离开标签的时候,才会将值赋予给 value,也就是在 change 事件之后再进行信息同步
html
<input type="text" v-model.lazy="value" />
<p>{{value}}</p>
  1. trim 自动过滤用户输入的首空格字符,而中间的空格不会过滤
html
<input type="text" v-model.trim="value" />
  1. number 自动将用户的输入值转为数值类型,但如果这个值无法被 parseFloat 解析,则会返回原来的值
html
<input v-model.number="age" type="number" />

二、事件修饰符

事件修饰符是对事件捕获以及目标进行了处理,有如下修饰符:

md
1. stop
2. prevent
3. self
4. once
5. capture
6. passive
7. native
  1. stop 阻止了事件冒泡,相当于调用了 event.stopPropagation 方法
html
<!-- 只调用shout(1) -->
<div @click="shout(2)">
  <button @click.stop="shout(1)">ok</button>
</div>
  1. prevent 阻止了事件的默认行为,相当于调用了 event.preventDefault 方法
html
<form @submit.prevent="onSubmit"></form>
  1. self 只当在 event.target 是当前元素自身时触发处理函数
html
<div @click.self="doThat">...</div>

注意

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

  1. once 绑定了事件以后只能触发一次,第二次就不会触发
html
<button @click.once="shout(1)">ok</button>
  1. capture 使事件触发从包含这个元素的顶层开始往下触发
html
<body>
  <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>
</body>
<!-- 输出顺序: 1 2 4 3 -->
  1. passive 在移动端,当我们在监听元素滚动事件的时候,会一直触发 onscroll 事件会让我们的网页变卡,因此我们使用这个修饰符的时候,相当于给 onscroll 事件整了一个.lazy 修饰符
html
<!-- 滚动事件的默认行为 (即滚动行为) 将会立即触发 -->
<!-- 而不会等待 `onScroll` 完成  -->
<!-- 这其中包含 `event.preventDefault()` 的情况 -->
<div @scroll.passive="onScroll">...</div>

注意

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

  1. native 让组件变成像 html 内置标签那样监听根元素的原生事件,否则组件上使用 v-on 只会监听自定义事件
html
<my-component @click.native="doSomething"></my-component>

注意

使用 .native 修饰符来操作普通 HTML 标签是会令事件失效的

三、鼠标按钮修饰符

提示

鼠标按钮修饰符针对的就是左键、右键、中键点击,有如下:

left 左键点击

right 右键点击

middle 中键点击

html
<button @click.left="shout(1)">ok</button>
<button @click.right="shout(2)">ok</button>
<button @click.middle="shout(3)">ok</button>

四、键盘修饰符

提示

键盘修饰符是用来修饰键盘事件(onkeyup,onkeydown)的: keyCode 存在很多,但 vue 为我们提供了别名,分为以下两种:

普通键(enter、tab、delete、space、esc、up...)

系统修饰键(ctrl、alt、meta、shift...)

html
<!-- 只有按键为keyCode的时候才触发 <input type="text" @keyup.keyCode="shout()" /> -->

还可以通过以下方式自定义一些全局的键盘码别名

js
Vue.config.keyCodes.f2 = 113

五、v-bind 修饰符

提示

v-bind 修饰符主要是为属性进行操作,用来分别有如下:

async

prop

camel

  1. async 能对 props 进行一个双向绑定
html
<!-- 父组件 -->
<comp :myMessage.sync="bar"></comp>
<!-- 子组件js this.$emit('update:myMessage',params); -->

以上这种方法相当于以下的简写

html
<!-- 父组件 -->
<comp :myMessage="bar" @update:myMessage="func"></comp>
<!-- 父组件js func(e){ this.bar = e; }  -->
<!-- 子组件js func2(){ this.$emit('update:myMessage', params); } -->

警告

使用 async 需要注意以下几点:

使用 sync 的时候,子组件传递的事件名格式必须为 update:value,其中 value 必须与子组件中 props 中声明的名称完全一致

注意带有 .sync 修饰符的 v-bind 不能和表达式一起使用

将 v-bind.sync 用在一个字面量的对象上,例如 v-bind.sync=”{ title: doc.title }”,是无法正常工作的

  1. props 设置自定义标签属性,避免暴露数据,防止污染 HTML 结构
html
<input id="uid" title="title1" value="1" :index.prop="index" />
  1. camel 将命名变为驼峰命名法,如将 view-Box 属性名转换为 viewBox
html
<svg :viewBox="viewBox"></svg>

六、总结

根据每一个修饰符的功能,我们可以得到以下修饰符的应用场景:

stop:阻止事件冒泡

native:绑定原生事件

once:事件只执行一次

self :将事件绑定在自身身上,相当于阻止事件冒泡

prevent:阻止默认事件

caption:用于事件捕获

once:只触发一次

keyCode:监听特定键盘按下

right:右键