目录
定义
事件修饰符 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>