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

Обзор

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

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

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

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

jqLite AngularJS

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

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

Дополнительные функции jQuery/jqLite

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

События

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

Методы

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