Spec-Zone.ru › Angular.js 1.4

Улучшить эту документацию Показать исходный код angular.element

  1. функция в модуле ng

Оборачивает элемент DOM или строку HTML в виде элемента jQuery.

Если jQuery доступен, angular.element является псевдонимом функции jQuery. Если jQuery недоступен, angular.element делегирует обработку встроенному подмножеству jQuery в Angular, называемому "jQuery Lite" или jqLite.

jqLite — это крошечное, совместимое с API подмножество jQuery, которое позволяет Angular манипулировать DOM в кроссбраузерном режиме. jqLite реализует только наиболее часто используемые функции с целью получения очень маленькой занимаемой памяти.

Чтобы использовать jQuery, просто убедитесь, что он загружен до файла angular.js. Вы также можете использовать директиву ngJq, чтобы указать, что должен использоваться jqlite вместо jQuery, или для использования определённой версии jQuery, если на странице присутствуют несколько версий.

Примечание: Все ссылки на элементы в Angular всегда оборачиваются с помощью jQuery или jqLite (например, аргумент element в функции компиляции/связывания директивы). Они никогда не являются сырыми ссылками DOM.
Примечание: Имейте в виду, что эта функция не будет находить элементы по имени тега/CSS-селектору. Для поиска по имени тега попробуйте вместо этого angular.element(document).find(...) или $document.find(), или используйте стандартные API DOM, например, document.querySelectorAll().

jqLite Angular

jqLite предоставляет только следующие методы jQuery:

  • addClass()
  • after()
  • append()
  • attr() — не поддерживает функции в качестве параметров
  • bind() — не поддерживает пространства имён, селекторы или eventData
  • children() — не поддерживает селекторы
  • clone()
  • contents()
  • css() — извлекает только встроенные стили, не вызывает getComputedStyle(). В качестве установщика не преобразует числа в строки или добавляет 'px', также не имеет автоматического префиксации свойств.
  • data()
  • detach()
  • empty()
  • eq()
  • find() — ограничено поиском по имени тега
  • hasClass()
  • html()
  • next() — не поддерживает селекторы
  • on() — не поддерживает пространства имён, селекторы или eventData
  • off() — не поддерживает пространства имён, селекторы или объект события в качестве параметра
  • one() — не поддерживает пространства имён или селекторы
  • parent() — не поддерживает селекторы
  • prepend()
  • prop()
  • ready()
  • remove()
  • removeAttr()
  • removeClass()
  • removeData()
  • replaceWith()
  • text()
  • toggleClass()
  • triggerHandler() — передает обработчикам фиктивный объект события.
  • unbind() — не поддерживает пространства имён или объект события в качестве параметра
  • val()
  • wrap()

Дополнения jQuery/jqLite

Angular также предоставляет следующие дополнительные методы и события для jQuery и jqLite:

События

  • $destroy — AngularJS перехватывает все API уничтожения DOM jqLite/jQuery и генерирует это событие для всех удаляемых узлов DOM. Это можно использовать для очистки любых внешних привязок к элементу DOM перед его удалением.

Методы

  • controller(name) — извлекает контроллер текущего элемента или его родительского элемента. По умолчанию извлекает контроллер, связанный с директивой ngController. Если name указан в виде имени директивы с camelCase, то будет извлечён контроллер для этой директивы (например, 'ngModel').
  • injector() — извлекает инжектор текущего элемента или его родительского элемента.
  • scope() — извлекает scope текущего элемента или его родительского элемента. Требуется, чтобы данные отладки были включены Debug Data.
  • isolateScope() — извлекает изолированный scope, если он прикреплен непосредственно к текущему элементу. Этот метод должен использоваться только для элементов, содержащих директиву, которая начинает новый изолированный scope. Вызов scope() для этого элемента всегда возвращает исходный, не изолированный scope. Требуется, чтобы данные отладки были включены Debug Data.
  • inheritedData() — аналогично data(), но переходит вверх по DOM, пока не будет найдено значение или не будет достигнут родительский элемент.

Использование

angular.element(element);

Аргументы

Параметр Тип Подробности
element stringDOMElement

Строка HTML или DOMElement, которые должны быть обернуты в jQuery.

Возвращаемое значение

Object

Объект jQuery.

© 2010–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.4.14/docs/api/ng/function/angular.element

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API