vue-修饰符

233 阅读8分钟

一、表单修饰符

填写表单常用的是什么? <input v-model="data"> 修饰符可以起到很大作用!

.lazy

<div>
   <input type="text" v-model="value">
   <p>{{value}}</p>
</div>

上面示例,每输入一个字符,下面就会实时现实显示。

image.png

但有时候我们我们需要,在输入完所有东西,光标离开才开始更新视图。

<div>
   <input type="text" v-model.lazy="value">
   <p>{{value}}</p>
</div>

这样即可~这样只有当我们光标离开输入框的时候,它才会更新视图,相当于在onchange事件触发更新。

.trim

在我们input输入时,需要过滤一些前后多余空格,可以使用 .trim 。

<div>
   <input type="text" v-model.trim="value">
   <p>{{value}}</p>
</div>

注意:trim仅过滤首尾的空格,中间的是不会过滤的

image.png

.number

number修饰符可以限制input输入的内容类型转为数字,但是有bug。

<div>
   <input type="text" v-model.number="value">
   <p>{{value}}</p>
</div>

1.先输入数字后,再输入其他类型字符,非数字的内容都可以正常过滤掉。 image.png

2.先输入数字后,再输入其他类型字符,然后再输入数字,后面数字也会被过滤掉。 image.png

3.先输入非数字字符,然后再输入数字,.number 修饰符处于失效状态。 image.png

总结:.number 修饰符只对,首字符为number类型有效限制,中断或首字符不为number类型,就会失效。

二、事件修饰符

.stop

由于事件冒泡的机制,我们给元素绑定点击事件的时候,也会触发父级的点击事件。

<div @click="shout(2)">
  <button @click="shout(1)">提交</button>
</div>

//js
shout(e){
  console.log(e)
}
// 1
// 2

在我们点击 ”提交“ 按钮时触发shout(1),同时也会触发父级shout(2)的事件。

下面我们在子元素添加.stop阻止事件冒泡,相当于调用了 event.stopPropagation() 方法。

<div @click="shout(2)">
  <button @click.stop="shout(1)">提交</button>
</div>

//js
shout(e){
  console.log(e)
}
// 1

.prevent

阻止默认事件

<!-- 阻止默认提交事件 -->
<form v-on:submit.prevent="mySubmit"></form>
<!--阻止默认提交事件 -->
<form>
    <input type="submit" v-on:click.prevent="mySubmit">
</form>

当点击提交按钮时阻止对表单的提交。相当于调用了event.preventDefault() 方法。

注意: 修饰符可以同时使用多个,但是可能会因为顺序而有所不同。

v-on:click.prevent.self 会阻止所有的点击。

v-on:click.self.prevent 只会阻止对元素自身的点击。

总结:多个修饰符同时使用,规则从左往右

.self

只当事件是从事件绑定的元素本身触发时才触发回调。

像下面所示,刚刚我们从.stop时候知道子元素会冒泡到父元素导致触发父元素的点击事件,当我们加了这个.self以后,我们点击”第二层“不会触发父元素的点击事件shout,只有当点击到父元素”第一层“时,才会shout从这个self的英文翻译过来就是‘自己,本身’可以看出这个修饰符的用法。

<div class="cl1" @click.self="dianji(1)">
    第一层
    <div class="cl2"  @click="dianji(2)">
      第二层
    </div>
</div>

.once

这个修饰符的用法也是和名字一样简单粗暴,只能用一次,绑定了事件以后只能触发一次,第二次就不会触发。

//键盘按坏都只能shout一次
<button @click.once="shout(1)">ok</button>

.capture

从上面我们知道了事件的冒泡,其实完整的事件机制是:捕获阶段--目标阶段--冒泡阶段。默认是事件触发是从目标开始往上冒泡。

当我们加了这个.capture以后呢,我们就反过来了,事件触发从包含这个元素的顶层开始往下触发。

  <div @click.capture="shout(1)">
      obj1
      <div @click="shout(2)">
        obj2
        <div @click="shout(3)">
          obj3
          <div @click="shout(4)">
            obj4
          </div>
        </div>
      </div>
    </div>
    // 1 2 4 3 

从上面这个例子我们点击obj4的时候,就可以清楚地看出区别,obj1,obj2在捕获阶段就触发了事件,因此是先1后2,后面的obj3,obj4是默认的冒泡阶段触发,因此是先4然后冒泡到3~

.passive

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

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

.native

我们经常会写很多的小组件,有些小组件可能会绑定一些事件,但是,像下面这样绑定事件是不会触发的

<My-component @click="shout(3)"></My-component>

必须使用.native来修饰这个click事件(即<My-component @click.native="shout(3)">),可以理解为该修饰符的作用就是把一个vue组件转化为一个普通的HTML标签

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

三、鼠标按钮修饰符

刚刚我们讲到这个click事件,我们一般是会用左键触发,有时候我们需要更改右键菜单啥的,就需要用到右键点击或者中间键点击,这个时候就要用到鼠标按钮修饰符

  • .left 左键点击
  • .right 右键点击
  • .middle 中键点击
<button @click.right="shout(1)">ok</button>

四、键值修饰符

.keyCode

如果不用keyCode修饰符,那我们每次按下键盘都会触发shout,当我们想指定按下某一个键才触发这个shout的时候,这个修饰符就有用了,具体键码查看键码对应表

<input type="text" @keyup.keyCode="shout(4)">

为了方便我们使用,vue给一些常用的键提供了别名

普通键

.enter 
.tab
.delete //(捕获“删除”和“退格”键)
.space
.esc
.up
.down
.left
.right

系统修饰键

.ctrl
.alt
.meta
.shift

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

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

我们从上面看到,键分成了普通常用的键和系统修饰键,区别是什么呢?

当我们写如下代码的时候,我们会发现如果仅仅使用系统修饰键是无法触发keyup事件的。

<input type="text" @keyup.ctrl="shout(4)">

那该如何呢?我们需要将系统修饰键和其他键码链接起来使用,比如

<input type="text" @keyup.ctrl.67="shout(4)">

这样当我们同时按下ctrl+c时,就会触发keyup事件。

另,如果是鼠标事件,那就可以单独使用系统修饰符。

<button @mouseover.ctrl="shout(1)">ok</button>
<button @mousedown.ctrl="shout(1)">ok</button>
<button @click.ctrl.67="shout(1)">ok</button>

大概是什么意思呢,就是你不能单手指使用系统修饰键的修饰符(最少两个手指,可以多个)。你可以一个手指按住系统修饰键一个手指按住另外一个键来实现键盘事件。也可以用一个手指按住系统修饰键,另一只手按住鼠标来实现鼠标事件。

.exact

我们上面说了这个系统修饰键,当我们像这样<button type="text" @click.ctrl="shout(4)">绑定了click键按下的事件,惊奇的是,我们同时按下几个系统修饰键,比如ctrl shift点击,也能触发,可能有些场景我们只需要或者只能按一个系统修饰键来触发(像制作一些快捷键的时候),而当我们按下ctrl和其他键的时候则无法触发。那就这样写。

注意:这个只是限制系统修饰键的,像下面这样书写以后你还是可以按下ctrl + c,ctrl+v或者ctrl+普通键 来触发,但是不能按下ctrl + shift +普通键来触发。

<button type="text" @click.ctrl.exact="shout(4)">ok</button>

然后下面这个你可以同时按下enter+普通键来触发,但是不能按下系统修饰键+enter来触发。相信你已经能听懂了8~

<input type="text" @keydown.enter.exact="shout('我被触发了')">

五、v-bind修饰符

  • .sync(2.3.0+ 新增)

在有些情况下,我们可能需要对一个 prop 进行“双向绑定”。不幸的是,真正的双向绑定会带来维护上的问题,因为子组件可以修改父组件,且在父组件和子组件都没有明显的改动来源。我们通常的做法是

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

现在这个.sync修饰符就是简化了上面的步骤

//父组件
<comp :myMessage.sync="bar"></comp> 

//子组件
this.$emit('update:myMessage',params)

这样确实会方便很多,但是也有很多需要注意的点

  1. 使用sync的时候,子组件传递的事件名必须为update:value,其中value必须与子组件中props中声明的名称完全一致(如上例中的myMessage,不能使用my-message)
  2. 注意带有 .sync 修饰符的 v-bind 不能和表达式一起使用 (例如 v-bind:title.sync=”doc.title + ‘!’” 是无效的)。取而代之的是,你只能提供你想要绑定的属性名,类似 v-model。
  3. 将 v-bind.sync 用在一个字面量的对象上,例如 v-bind.sync=”{ title: doc.title }”,是无法正常工作的,因为在解析一个像这样的复杂表达式的时候,有很多边缘情况需要考虑。

.prop

要学习这个修饰符,我们首先要搞懂两个东西的区别。

Property:节点对象在内存中存储的属性,可以访问和设置。
Attribute:节点对象的其中一个属性( property ),值是一个对象。
可以通过点访问法 document.getElementById('xx').attributes 或者 document.getElementById('xx').getAttributes('xx') 读取,通过 document.getElementById('xx').setAttribute('xx',value) 新增和修改。
在标签里定义的所有属性包括 HTML 属性和自定义属性都会在 attributes 对象里以键值对的方式存在。

其实attribute和property两个单词,翻译出来都是属性,但是《javascript高级程序设计》将它们翻译为特性和属性,以示区分

//这里的id,value,style都属于property
//index属于attribute
//id、title等既是属性,也是特性。修改属性,其对应的特性会发生改变;修改特性,属性也会改变
<input id="uid" title="title1" value="1" :index="index">
//input.index === undefined
//input.attributes.index === this.index

从上面我们可以看到如果直接使用v-bind绑定,则默认会绑定到dom节点的attribute。
为了

  • 通过自定义属性存储变量,避免暴露数据
  • 防止污染 HTML 结构

我们可以使用这个修饰符,如下

<input id="uid" title="title1" value="1" :index.prop="index">
//input.index === this.index
//input.attributes.index === undefined

.camel

由于HTML 特性是不区分大小写的。

<svg :viewBox="viewBox"></svg>

实际上会渲染为

<svg viewbox="viewBox"></svg>

这将导致渲染失败,因为 SVG 标签只认 viewBox,却不知道 viewbox 是什么。
如果我们使用.camel修饰符,那它就会被渲染为驼峰名。
另,如果你使用字符串模版,则没有这些限制。

new Vue({
  template: '<svg :viewBox="viewBox"></svg>'
})