例:自定義鍵盤信息
Vue.directive('on').keyCodes.ctrl=17;
Vue.directive('on').keyCodes.myenter=13;
window.onload = function(){
var vm = new Vue({
el:'#box',
data:{},
methods:{
show:function(){
alert(111);
}
}
});
}
<input type="text" @keydown.ctrl="show">
<hr>
<input type="text" @keydown.myenter="show | debounce 2000">
自定義指令
1卤妒、Vue.directive(id,definition)注冊(cè)一個(gè)全局自定義指令甥绿,接收兩個(gè)參數(shù)叠必,指令I(lǐng)D以及定義對(duì)象
2、鉤子函數(shù):將作用域與DOM進(jìn)行鏈接妹窖,鏈接函數(shù)用來(lái)創(chuàng)建可以操作DOM的指令
bind - 只調(diào)用一次纬朝,在指令第一次綁定到元素上時(shí)候調(diào)用
update - 在bind之后立即以初始值為參數(shù)第一次調(diào)用,之后綁定值變化的時(shí)候骄呼,參數(shù)為新值與舊值
unbind - 只調(diào)用一次共苛,在指令從元素上解綁的時(shí)候調(diào)用
Vue.directive('my-directive',{
bind : function(){
//準(zhǔn)備工作
//例如,添加事件處理器或只需要運(yùn)行一次的高耗任務(wù)
},
update : function(){
//值更新時(shí)的工作
//也會(huì)以初始值為參數(shù)調(diào)用一次
},
unzind : function(){
//清理工作
//例如蜓萄,刪除bind()添加的事件監(jiān)聽器
}
})
//調(diào)用
<div v-my-directive="someValue"></div>
//只需要update函數(shù)隅茎,可以傳一個(gè)函數(shù)替代定義對(duì)象
Vue.directive('my-directive',function(value){})
<!-- 如果指令需要多個(gè)值,可以傳入一個(gè)js對(duì)象 -->
<!-- 指令可以使用合法的js表達(dá)式 -->
<body id="example">
<div id="demo" v-demo="{color : 'white',text : 'hello!'}"></div>
</body>
<script>
Vue.directive('demo',function(value){
console.info(value.color); //white
console.info(value.text) // hello!
})
var demo = new Vue({
el : '#demo'
})
</script>
當(dāng)指令使用字面修飾符嫉沽,值將按普通字符串處理并傳遞給update方法辟犀,update方法只調(diào)用一次,因?yàn)槠胀ㄗ址荒苡绊憯?shù)據(jù)變化
<body id="example">
<div id="demo" v-demo.literal="foo bar baz"></div>
</body>
<script>
Vue.directive('demo',function(value){
console.info(value); //foo bar baz
})
var demo = new Vue({
el : '#demo'
})
</script>
3绸硕、以屬性的形式使用自定義屬性
<body id="demo">
<my-directive class="hello" name="hi"></my-directive>
</body>
<script type="text/javascript">
Vue.elementDirective('my-directive',{
//api同普通指令一致
bind : function(){
console.info(this.el.className);
console.info(this.el.getAttribute('name'))
}
})
var demo = new Vue({
el : '#demo'
})
</script>
4堂竟、自定義屬性用在對(duì)象上,對(duì)象內(nèi)部屬性變化的時(shí)候觸發(fā)update玻佩,在指令定義對(duì)象中指定deep:true
<body id="demo">
<div v-my-directive="a"></div>
<button @click="change">change</button>{{a,b,c}}
</body>
<script>
Vue.directive('my-directive',function(){
deep : true,
update : function(obj){
//當(dāng)obj的嵌套屬性變化時(shí)候調(diào)用
console.info(obj.b.c);
}
})
var demoVM = new Vue({
el : '#demo',
data : {
a : {b : {c : 2}}
},
method : {
change : function(){
demoVM.a.b.c = 4;
}
}
})
</script>
5出嘹、acceptStatement讓自定義指令接受內(nèi)聯(lián)語(yǔ)句
<body id="demo">
<div v-my-directive="a++"></div>
{{a}}
</body>
<script>
Vue.directive('my-directive',function(){
acceptStatement : true,
update : function(fn){
//當(dāng)obj的嵌套屬性變化時(shí)候調(diào)用
console.info(fn.toString())
fu();
}
})
var demoVM = new Vue({
el : '#demo',
data : {
a : 5
}
})
</script>
6、v-on綁定多個(gè)事件時(shí)咬崔,要是是不同的事件類型税稼,例如點(diǎn)擊,focus垮斯,change郎仆,會(huì)按照業(yè)務(wù)需求進(jìn)行
選擇,要是綁定了2個(gè)甚至多個(gè)click事件兜蠕,那么v-on只會(huì)綁定第一個(gè)click事件
附自定義拖拽指令
<body>
<div id="box">
<div v-drag :style="{width:'100px', height:'100px', background:'blue', position:'absolute', right:0, top:0}"></div>
<div v-drag :style="{width:'100px', height:'100px', background:'red', position:'absolute', left:0, top:0}"></div>
</div>
</body>
<script>
window.onload=function(){
Vue.directive('drag',{
inserted: function (el) {
var oDiv=el;
oDiv.onmousedown=function(ev){
var disX=ev.clientX-oDiv.offsetLeft;
var disY=ev.clientY-oDiv.offsetTop;
document.onmousemove=function(ev){
var l=ev.clientX-disX;
var t=ev.clientY-disY;
oDiv.style.left=l+'px';
oDiv.style.top=t+'px';
};
document.onmouseup=function(){
document.onmousemove=null;
document.onmouseup=null;
};
};
}
});
var vm=new Vue({
el:'#box',
data:{
msg:''
}
});
};
</script>
字面指令
如果在創(chuàng)建自定義指令的時(shí)候傳入 isLiteral: true 扰肌,那么特性值就會(huì)被看成直接字符串,并被賦值給該指令的 expression牺氨。字面指令不會(huì)試圖建立數(shù)據(jù)監(jiān)視狡耻。
例子:
<div v-literal-dir="foo"></div>
Vue.directive('literal-dir', {
isLiteral: true,
bind: function () {
console.log(this.expression) // 'foo'
}
})
動(dòng)態(tài)字面指令
然而墩剖,在字面指令含有 Mustache 標(biāo)簽的情形下猴凹,指令的行為如下:
指令實(shí)例會(huì)有一個(gè)屬性,this._isDynamicLiteral被設(shè)為true岭皂;
如果沒(méi)有提供update函數(shù)郊霎,Mustache 表達(dá)式只會(huì)被求值一次,并將該值賦給this.expression爷绘。不會(huì)對(duì)表達(dá)式進(jìn)行數(shù)據(jù)監(jiān)視书劝。
如果提供了update函數(shù)进倍,指令將會(huì)為表達(dá)式建立一個(gè)數(shù)據(jù)監(jiān)視,并且在計(jì)算結(jié)果變化的時(shí)候調(diào)用update购对。
雙向指令
如果你的指令想向 Vue 實(shí)例寫回?cái)?shù)據(jù)猾昆,你需要傳入 twoWay: true 。該選項(xiàng)允許在指令中使用
this.set(value)骡苞。
Vue.directive('example', {
twoWay: true,
bind: function () {
this.handler = function () {
// 把數(shù)據(jù)寫回 vm
// 如果指令這樣綁定 v-example="a.b.c",
// 這里將會(huì)給 `vm.a.b.c` 賦值
this.set(this.el.value)
}.bind(this)
this.el.addEventListener('input', this.handler)
},
unbind: function () {
this.el.removeEventListener('input', this.handler)
}
})
元素指令
有時(shí)候垂蜗,我們可能想要我們的指令可以以自定義元素的形式被使用,而不是作為一個(gè)特性。這與 Angular 的 E 類指令的概念非常相似。元素指令可以看做是一個(gè)輕量的自定義組件(后面會(huì)講到)直颅。你可以像下面這樣注冊(cè)一個(gè)自定義的元素指令:
Vue.elementDirective('my-directive', {
// 和普通指令的 API 一致
bind: function () {
// 對(duì) this.el 進(jìn)行操作...
}
})
使用時(shí)我們不再用這樣的寫法:
<div v-my-directive></div>
而是寫成:
<my-directive></my-directive>
元素指令不能接受參數(shù)或表達(dá)式邑茄,但是它可以讀取元素的特性,來(lái)決定它的行為打颤。與通常的指令有個(gè)很大的不同,元素指令是終結(jié)性的,這意味著档悠,一旦 Vue 遇到一個(gè)元素指令,它將跳過(guò)對(duì)該元素和其子元素的編譯 - 即只有該元素指令本身可以操作該元素及其子元素望浩。