Spec-Zone.ru › Angular.js 1.2

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

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

jqLite Angular

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

  • addClass()
  • after()
  • append()
  • attr()
  • bind() — не поддерживает пространства имён, селекторы или данные событий
  • children() — не поддерживает селекторы
  • clone()
  • contents()
  • css() — извлекает только встроенные стили, не вызывает getComputedStyles()
  • data()
  • empty()
  • eq()
  • find() — ограничено поиском по имени тега
  • hasClass()
  • html()
  • next() — не поддерживает селекторы
  • on() — не поддерживает пространства имён, селекторы или данные событий
  • 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 текущего элемента или его родителя.
  • isolateScope() — извлекает изолированный scope, если он присоединён непосредственно к текущему элементу. Этот метод следует использовать только для элементов, содержащих директиву, которая запускает новый изолированный scope. Вызов scope() для этого элемента всегда возвращает исходный, неизолированный scope.
  • inheritedData() — аналогично data(), но проходит по DOM вверх, пока не найдёт значение или не достигнет родительского элемента.

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

angular.element(element);

Аргументы

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

Строка HTML или элемент DOM, который необходимо обернуть в jQuery.

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

Object

Объект jQuery.

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

Spec-Zone.ru

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