Vue.js Пользовательские директивы

В дополнение к основным директивам, заданным по умолчанию (v-model и v-show), Vue также позволяет регистрировать пользовательские директивы.

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

Пример

<div id="app"> <p>Когда страница загружается, элемент input автоматически получает фокус:</p> <input v-focus> </div> <script>// Регистрация глобальной пользовательской директивы v-focus Vue.directive('focus', { // Вызывается, когда привязанный элемент вставлен в DOM. inserted: function (el) { // Установить фокус на элементе el.focus() } }) // Создать корневой экземпляр new Vue({ el: '#app' })</script>

Попробуйте сами »

Мы также можем использовать опцию directives в экземпляре для регистрации локальных директив, чтобы директива могла использоваться только в этом экземпляре:

Пример

<div id="app"> <p>Когда страница загружается, элемент input автоматически получает фокус:</p> <input v-focus> </div> <script>// Создать корневой экземпляр new Vue({ el: '#app', directives: { // Зарегистрировать локальную пользовательскую директиву v-focus focus: { // Определение директивы inserted: function (el) { // Установить фокус на элементе el.focus() } } } })</script>

Попробуйте сами »

Хуки

Функции-хуки

Функция определения директивы предоставляет несколько функций-хуков (необязательно):

  • bindВызывается только один раз, когда директива впервые привязывается к элементу. Эту функцию-хук можно использовать для определения действия инициализации, которое выполняется один раз при привязке.

  • insertedВызывается, когда привязанный элемент вставлен в свой родительский узел (он должен существовать только в родительском узле, необязательно в документе).

  • updateВызывается, когда шаблон, содержащий привязанный элемент, обновляется, независимо от того, изменяется ли значение привязки. Сравнивая значение привязки до и после обновления, можно игнорировать ненужные обновления шаблона (подробные параметры функций-хуков см. ниже).

  • componentUpdatedВызывается, когда шаблон, содержащий привязанный элемент, завершает цикл обновления.

  • unbindВызывается только один раз, когда директива отвязывается от элемента.

Параметры функции-хука

Параметры функции-хука:

  • elЭлемент, привязанный к директиве, который можно использовать для непосредственного управления DOM.
  • bindingОбъект, содержащий следующие свойства:
    • nameИмя директивы, исключаяv-префикс.
    • valueЗначение привязки директивы, например:v-my-directive="1 + 1"значение value равно2。
    • oldValueПредыдущее значение, привязанное директивой, доступно только вupdateиcomponentUpdatedхуке. Оно доступно независимо от того, изменяется ли значение.
    • expressionВыражение или имя переменной значения привязки. Напримерv-my-directive="1 + 1"значение expression равно"1 + 1"。
    • argАргумент, переданный директиве. Напримерv-my-directive:fooзначение arg равно"foo"。
    • modifiersОбъект, содержащий модификаторы. Например:v-my-directive.foo.barзначение объекта modifiers равно{ foo: true, bar: true }。
  • vnodeВиртуальный узел, созданный при компиляции Vue.
  • oldVnodeПредыдущий виртуальный узел, доступный только вupdateиcomponentUpdatedхуке.

В следующем примере показано использование этих параметров:

Пример

<div id="app" v-example:hello.a.b="message"> </div> <script> Vue.directive('example', { bind: function (el, binding, vnode) { var s = JSON.stringify el.innerHTML = 'name: ' + s(binding.name) + '<br>' + 'value: ' + s(binding.value) + ' } })<br>' + 'выражение: ' + s(binding.expression) + '<br>' + 'аргумент: ' + s(binding.arg) + '<br>' + 'модификаторы: ' + s(binding.modifiers) + '<br>' + 'ключи vnode: ' + Object.keys(vnode).join(', ') } }) new Vue({ el: '#app', data: { message: 'Пример!' } })</script>

Попробуйте сами »

Иногда нам не нужны другие функции-хуки, и мы можем использовать сокращённую форму функции, как показано ниже:

Vue.directive('example', function (el, binding) {
  // 设置指令的背景颜色
  el.style.backgroundColor = binding.value.color
})

Функции директив могут принимать все допустимые выражения JavaScript. В следующем примере передаётся объект JavaScript:

Пример

<div id="app"> <div v-example="{ color: 'green', text: 'Example!' }"></div> </div> <script>Vue.directive('example', function (el, binding) { // Use shorthand to set text and background color el.innerHTML = binding.value.text el.style.backgroundColor = binding.value.color }) new Vue({ el: '#app' })</script>

Попробуйте сами »
Другие расширения