自定义指令

基础简介

除了核心功能默认的内置指令(v-model和v-show),vue也允许注册自定义指令。注意,在Vue2.0中,代码复用和抽象的主要形式是组件,但是在有些情况下,我们需要对普通的DOM元素进行底层操作,这时候就需要我们用到自定义指令。

简单事例,当页面加载时元素就会获得焦点,但是实际上只要我们代码完成,页面没打开时这个输入框已经是聚焦状态:

    <!DOCTYPE html>
    <html lang="en">
    <head>
      <meta charset="utf-8">
      <script src="Vue.min.js"></script>
    </head>
    
    <body>
      <div id="app">
        <input v-focus>
      </div>
      <script>
        //注册一个全局自定义指令v-focus
        Vue.directive('focus', {
          // 当绑定元素插入到DOM中
          inserted: function (el) {
            // 聚焦元素
            el.focus()
          }
        });
        var app = new Vue({
          el: '#app'
        });
      </script>
    </body>
    </html>

钩子函数

我们可以使用Vue.directive的方法传入执行id和定义对象来注册一个全局的自定义指令,一个指令对象可以提供几个钩子函数:

  • bind:只调用一次,指令第一次绑定元素的时候调用,这时我们可以进行对它的一次性初始化设置。
  • inserted,被绑定元素插入父节点时的调用。
  • update,所在组件的 VNode 更新时调用,但是可能发生在组件的 VNode更新前,因此指令的值是不确定的,可能有也可能没有。
  • componentUpdated,指令所在组件的 VNode以及它之后的更新调用。
  • unbind,只调用一次,指令与元素解绑时调用。

定义对象的钩子函数参数有(除了el之外其他参数都是只读的):

  • el:指令绑定的元素,可以被用来直接操作DOM。
  • binding

    • name:指令名,不包括 v- 前缀。
    • value:指令的绑定值,例如:v-new-xkd:"1+2";,绑定值为3。
    • oldValue:指令绑定的前一个值,只在update 和 componentUpdated 钩子中使用。
    • expression:字符串形式的指令表达式。例如上面 v-new-xkd中的"1+2"。
    • arg:传给指令的参数。
    • modifiers:一个包含修饰符的对象。
  • vnode:Vue 编译生成的虚拟节点。
  • oldVnode:上一个虚拟节点。

指令的参数可以是动态的。

自定义钩子函数属性事例:

    <!DOCTYPE html>
    <html lang="en">
    <head>
      <meta charset="utf-8">
      <script src="Vue.min.js"></script>
    </head>
    
    <body>
      <div id="hook" v-xkd:foo.a.b="message"></div>
    
      <script>
        // 使用自定义指令
        Vue.directive('xkd', {
          // 指令在绑定到元素要执行的操作
          bind: function (el, binding, vnode) {
          var w = JSON.stringify;
          // 准备将传递来的参数显示在调用该指令的元素的innerHTML上
          el.innerHTML =
            'name: ' + w(binding.name) + '<br><br>' +
            'value: ' + w(binding.value) + '<br><br>' +
            'expression: ' + w(binding.expression) + '<br><br>' +
            'argument: ' + w(binding.arg) + '<br><br>' +
            'modifiers: ' + w(binding.modifiers) + '<br><br>' +
            'vnode keys: ' + Object.keys(vnode).join(', ')
          }
        })
        // 创建自定义指令
        new Vue({
          el: '#hook',
          data: {
            message: '侠课岛'
          }
        })
      </script>
    </body>
    </html>

函数简写

大多数情况下,可能想在bind和update钩子上做重复动作,并且不想关心其它的钩子函数,可以这样写:

    Vue.directive('func-abbr', function (el, binding) {
      el.style.backgroundColor = binding.value
    })

对象字面量

如果指令需要多个值,那么可以传入一个JavaScript对象字面量;同一个特性内部,逗号隔开的多个从句被绑定为多个指令实例。

    <div id="hook" v-demo="{ color: 'green', text: 'Chivalrous Island!'}"></div>
    
    <script>
        Vue.directive('demo', function (el, binding) {
          console.log(binding.value.color);
          console.log(binding.value.text);
        })
    
        // 创建自定义指令
        new Vue({
          el: '#hook',
          data: {
            message: '侠课岛'
          }
        })
    </script>
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章