Spec-Zone.ru › Angular.js 1.3

Улучшить эту документацию Просмотреть исходный код 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.

Примечание: все ссылки на элементы в Angular всегда оборачиваются с помощью jQuery или jqLite; они никогда не являются сырыми ссылками на DOM.

Angular's jqLite

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 jqLite/jQuery по уничтожению DOM и вызывает это событие для всех удаляемых узлов DOM. Это можно использовать для очистки любых привязок сторонних модулей к элементу DOM перед его удалением.

Методы

  • controller(name) — извлекает контроллер текущего элемента или его родителя. По умолчанию извлекает контроллер, связанный с директивой ngController. Если name предоставлен в формате camelCase, то будет извлечён контроллер для этой директивы (например, 'ngModel').
  • injector() — извлекает инжектор текущего элемента или его родителя.
  • scope() — извлекает scope текущего элемента или его родителя. Требуется включение Данных отладки.
  • isolateScope() — извлекает изолированный scope, если он прикреплён непосредственно к текущему элементу. Этот метод должен использоваться только для элементов, содержащих директиву, которая начинает новый изолированный scope. Вызов scope() для этого элемента всегда возвращает исходный, не изолированный scope. Требуется включение Данных отладки.
  • 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.3.20/docs/api/ng/function/angular.element

Spec-Zone.ru

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