v-on 事件指令用于绑定事件。

1 基础用法

v-on 指令绑定事件后，就会监听相应的事件。

html：

<div id="app">
    <h3>已点击 {{count}} 次</h3>
    <button @click="count++">点我</button>
</div>

注意： @click 是 v-on:click 的简写形式， @ 即表示 v-on:。

js：

<script>
    var app = new Vue({
        el: '#app',
        data: {
            count:0
        }
    });
</script>

效果：

@click 表达式即可以直接使用 js 语句，也可以是一个定义在 vue 实例中 methods 内的函数名。

html：

<button @click="quickAdd(3)">快速增长</button>

js：

methods: {
    quickAdd: function (i) {
        i = i || 1;//为避免参数为 null 或 undefined 值，这里设定了默认值 1
        this.count += i;
    }
}

效果：

注意： @click 调用的方法名如果不需要参数，那么可以不写括号。

使用 Vue.js 的一个好处是：当销毁 ViewModel 时，会自动销毁所有绑定在其上的事件处理器。

2 调用 DOM 事件

Vue.js 还提供了一个 $event 变量，使用它可以访问原生 DOM 事件。$event 变量可以通过方法传入。

html：

<div id="app2">
    <a href="www.163.com" @click="openUrl('被禁用咯',$event)">被禁用咯</a>
</div>

js：

var app2 = new Vue({
    el: '#app2',
    data: {
        count: 0
    },
    methods: {
        openUrl: function (param, event) {
            event.preventDefault();
            console.log("param:" + param);
        }
    }
});

输出结果：

param:被禁用咯

这个示例利用传入的 event 参数，禁用了原有的链接跳转逻辑。

3 事件修饰符

Vue.js 支持以下事件修饰符：

事件修饰符	示例	示例说明
.stop	@click.stop	阻止单击事件冒泡。
.prevent	@submit.prevent	提交页面不再重载页面。
.capture	@click.capture	添加事件监听器时使用事件捕获模式。
.self	@click.self	只有当单击事件是元素的自身事件时，才会触发。
.once	@click.once	只触发一次。

4 按键修饰符

可以使用按键修饰符，来监听表单元素上的键盘事件。

html：

<div id="app3">
    <input @keyup.13="enterClick">
</div>

js：

var app3 = new Vue({
    el: '#app3',
    data: {},
    methods: {
        enterClick: function () {
            console.log("enterClick");
        }
    }
});

输出结果：

enterClick

这个示例演示了如何通过回车按键修饰符来绑定事件函数的过程。

除了使用 keycode 来指定按键之外，我们还可以使用以下这些按键别名：

• .enter
• .tab
• .delete
• .esc
• .space
• .up
• .down
• .left
• .right

还有一些按键修饰符可以组合使用，或者和鼠标一起使用：

• .ctrl
• .alt
• .shift
• .meta：Mac 下为 Command 键，Windows 下为窗口键。

html：

<div id="app4">
    <input @keyup.alt.83="save">
</div>

js：

var app4 = new Vue({
    el: '#app4',
    data: {},
    methods: {
        save: function () {
            console.log("save");
        }
    }
});

输出结果：

save

这个示例，我们通过组合按键修饰符，为输入框绑定了 alt + S 事件。

---

本文示例（DEMO）