Vue.js Пользовательские директивы
В дополнение к основным директивам, заданным по умолчанию (v-model и v-show), Vue также позволяет регистрировать пользовательские директивы.
Ниже мы регистрируем глобальную директиву v-focus, которая заставляет элемент получать фокус при загрузке страницы:
Пример
Попробуйте сами »
Мы также можем использовать опцию directives в экземпляре для регистрации локальных директив, чтобы директива могла использоваться только в этом экземпляре:
Пример
Попробуйте сами »
Хуки
Функции-хуки
Функция определения директивы предоставляет несколько функций-хуков (необязательно):
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 }。
- nameИмя директивы, исключая
- vnodeВиртуальный узел, созданный при компиляции Vue.
- oldVnodeПредыдущий виртуальный узел, доступный только в
updateиcomponentUpdatedхуке.
В следующем примере показано использование этих параметров:
Пример
Попробуйте сами »
Иногда нам не нужны другие функции-хуки, и мы можем использовать сокращённую форму функции, как показано ниже:
Vue.directive('example', function (el, binding) {
// 设置指令的背景颜色
el.style.backgroundColor = binding.value.color
})
Функции директив могут принимать все допустимые выражения JavaScript. В следующем примере передаётся объект JavaScript:
Пример
Попробуйте сами »