Пользовательские Директивы

Vue также позволяет нам регистрировать наши собственные пользовательские директивы помимо набора по умолчанию директив, которые поставляются в ядре (v-show и v-model). В Vue 2.0 основное повторное использование и абстракция кода - это компоненты, однако могут быть случаи, когда нам нужен некоторый низкоуровневый доступ к DOM для простых элементов, здесь будут по-прежнему полезны пользовательские директивы. Типичный пример - фокусировка на элементе ввода, таком как текст ввода.

При загрузке страницы элемент получает фокус (Примечание: автофокус не работает в мобильном сафари). Если после посещения страницы никто не нажимал ни на что другое, ввод текста должен быть сфокусирован. Давайте построим директиву, которая выполнит это:

JS

// Registering a global custom directive called `v-focus`
Vue.directive('focus', {
  // When the bound element is inserted into the DOM...
  inserted: function (el) {
    // Focus the element
    el.focus()
  }
})

Вместо этого, если мы хотим зарегистрировать директиву локально, компоненты также принимают опцию директив:

directives: {
  focus: {
    // directive definition
    inserted: function (el) {
      el.focus()
    }
  }
}

Теперь мы можем использовать новый атрибут v-focus для любого элемента в нашем шаблоне, как показано ниже:

<input v-focus>

Крюк Функции

Объектом определения директивы может быть предоставлено несколько хуковских функций:

• bind: это вызывается только один раз, когда директива сначала привязана к элементу. Здесь мы можем выполнить разовую настройку.
• вставлено: это вызывается, когда связанный элемент был вставлен в его родительский узел (это только гарантирует присутствие родительского узла, а не обязательно в документе).
• update: вызывается после обновления VNode содержащего компонента, но, возможно, перед обновлением его дочерних элементов. Значение директивы может изменяться или не изменяться, но мы можем пропустить ненужные обновления, сравнивая текущие и старые значения привязки (см. Аргументы ловушки ниже).
• componentUpdated: это вызывается после того, как VNode содержащего компонента и VNodes его дочерних элементов обновлены.
• unbind: вызывается только один раз, когда директива не связана с элементом.

В следующем разделе мы рассмотрим аргументы, передаваемые в эти хуки.

Директива Аргументы Крюка

директивные аргументы не всегда статичны; они могут быть динамичными. Например, в v-mydirective: [аргумент] = "значение" аргумент может быть обновлен на основе свойств данных в нашем экземпляре компонента !. Таким образом, наши пользовательские директивы гибки во всем приложении.

Допустим, мы хотим создать собственную директиву, которая позволит нам прикреплять элементы к нашей странице с помощью фиксированного позиционирования. Мы могли бы создать пользовательскую директиву, где значение будет обновлять вертикальное положение в пикселях, как показано ниже:

HTML

<div id="baseexample">
  <p>Scroll down the page</p>
  <p v-pin="200">Stick me 200px from the top of the page</p>
</div>

JS

Vue.directive('pin', {
  bind: function (el, binding, vnode) {
    el.style.position ='fixed'
    el.style.top = binding.value + 'px'
  }
})
new Vue({
  el: '#baseexample'
})

Этот фрагмент будет закреплять элемент на 200 пикселей сверху страницы. Как насчет того, когда нам нужно прикрепить элемент слева, а не сверху? Использование динамического аргумента, который может быть обновлен для каждого экземпляра компонента, очень удобно:

HTML

<div id="dynamicexample">
  <h3>Scroll down inside this section ?</h3>
  <p v-pin:[direction]="200">I am pinned onto the page at 200px to the left.</p>
</div>

JS

Vue.directive('pin', {
  bind: function (el, binding, vnode) {
    el.style.position ='fixed'
    var s = (binding.arg =='left' ? 'left' : 'top')
    el.style[s] = binding.value + 'px'
  }
})
new Vue({
  el: '#dynamicexample',
  data: function () {
    return {
      direction: 'left'
    }
  }
})

Благодаря этому наша пользовательская директива достаточно гибкая, чтобы поддерживать различные варианты использования.

Функция Сокращения

Есть очень много случаев, когда мы можем хотеть того же поведения при связывании и обновлении, и не заботиться о других хуках. Например:

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

Объектные литералы

Если нашей директиве нужно несколько значений, мы также можем передать литерал объекта JavaScript.

HTML

<div v-demo="{ color: 'white', text: 'hello!' }"></div>

JS

Vue.directive('demo', function (el, binding) {
  console.log(binding.value.color) // => "white"
  console.log(binding.value.text)  // => "hello!"
})