tuna.dom

Область имен функций для работы с DOM-моделью.

Методы

[static] addChildEventListener:

Установка обработчика событий дочерних элементов выбранного DOM-элемента. Данный обработчик возможно использовать лишь для тех событий, для которых возможен баблинг. Для указания дочерних элементов, события которых необходимо отлавливать используется CSS-селектор. В случае если выбранный DOM-элемент удовлетворяет селектору дочерних элементов обработчик не срабатывает.

Аргументы:

Имя Тип Описание
element Node DOM-элемент, событие дочерних элементов которого нужно обрабатывать.
selector string CSS-селектор дочерних элементов.
type string Тип обрабатываемого события.
handler function(Event) Функция-обработчик события.

См. также:

[static] addClass:

Добавление CSS-класса элементу. В случае наличия класса у элемента ничего не происходит.

Аргументы:

Имя Тип Описание
element Node DOM-элемент класс которому нужно добавить.
className string CSS-класс который нужно добавить.

[static] addEventListener:

Добавление обработчика события DOM-елемента. Все обработчик событий вызываются в контексте элемента, оповещение о событии которого произошло.

Аргументы:

Имя Тип Описание
element Node DOM-элемент, событие которого нужно обрабатывать.
type string Тип обрабатываемого события.
handler function(Event) Функция-обработчик события.

См. также:

[static] addOneEventListener:

Добавление единовременного обработчика события. После первого вызова обработчик события удаляется.

Аргументы:

Имя Тип Описание
element Node DOM-элемент, событие которого нужно обрабатывать.
type string Тип обрабатываемого события.
handler function(Event) Функция-обработчик события.

[static] createFragment:DocumentFragment

Создание экземпряра класса DocumentFragment cожержащий указанный HTML контент.

Аргументы:

Имя Тип Описание
html string Строка HTML-верстки контента.

Возвращает:

  • Экземпляр класса DocumentFragment.

[static] dispatchEvent:boolean

Оповещение слушателей о событии DOM-элемента типа type.

Аргументы:

Имя Тип Описание
element Node DOM-элемент о событии которого необходимо оповестить.
type string Тип события.

Возвращает:

  • Успех результата оповещения.

См. также:

[static] getAttributesData:Object.

Извлечение данных DOM-элемента установленных в аттрибутах с префиксом data-. Результатом извлечения является хеш-таблица в которой ключами являются имена аттрибутов без префикса data-. Например, для элемента

извлеченные данные будут иметь вид: { 'name': 'Paragraph', 'some-value': '23' }

Аргументы:

Имя Тип Описание
element Node DOM-элемент, данные которого необходимо извлечь.

Возвращает:

  • Таблица данных элемента.

[static] getElementsByClassName:Array.

Поиск элементов с указанным CSS-классом, в указанном контексте.

Аргументы:

Имя Тип Описание
className string Название CSS-класса.
element Node DOM-элемент в котором необходимо провести поиск.

Возвращает:

  • Массив найденных элементов.

[static] getParentMatches:Node

Взятие ближайшего родителя DOM-элемента соответсвующего выбранному CSS-селектору.

Аргументы:

Имя Тип Описание
element Node DOM-элемент родителя которого нужно найти.
selector string CSS-селектор которому должен соответсовать родительский элемент.
opt_context Node DOM-элемент ограничивающий поиск родителя.

Возвращает:

  • Hайденный родительский элемент или null.

См. также:

[static] getParentWithClass:Node

Взятие ближайшего родителя DOM-элемента который имеет выбранный CSS-класс.

Аргументы:

Имя Тип Описание
element Node DOM-элемент родителя которого нужно найти.
className string Название CSS-класса родителя с которым необходимо найти.
opt_context Node DOM-элемент ограничивающий поиск родителя.

Возвращает:

  • Hайденный родительский элемент или null.

[static] hasClass:boolean

Проверка наличия CSS-класса элемента.

Аргументы:

Имя Тип Описание
element Node DOM-элемент наличие класса которого нужно проверить.
className string Название CSS-класса.

Возвращает:

  • Результат проверки.

[static] matches:Array.

Фильтрация набора элементов с условием соответствия CSS-селектору.

Аргументы:

Имя Тип Описание
selector string CSS-селектор которому должны соответсвовать элементы.
elements Array.<Node> Массив элементов, которые необходимо отфильтровать.

Возвращает:

  • Отфильтрованный массив элементов.

[static] matchesSelector:boolean

Проверка соответствия элемента CSS-селектору.

Аргументы:

Имя Тип Описание
element Node DOM-элемент соответствие которого нужно проверить.
selector string CSS-селектор которому должен соответсвовать элемент.

Возвращает:

  • Результат проверки.

[static] preventDefault:

Кросс-браузерная обертка остановки дествия события по-умолчанию.

Аргументы:

Имя Тип Описание
event Event Объект DOM-события.

[static] removeChildEventListener:

Удаление обработчика событий дочерних элементов выбранного DOM-элемента.

Аргументы:

Имя Тип Описание
element Node DOM-элемент, обработчик события дочерних элементов которого нужно удалить.
selector string CSS-селектор дочерних элементов.
type string Тип обрабатываемого события.
handler function(Event) Функция-обработчик события.

См. также:

[static] removeClass:

Удаление CSS-класса у элемента.

Аргументы:

Имя Тип Описание
element Node DOM-элемент класс готорого нужно удалить.
className string CSS-класс который нужно удалить.

[static] removeEventListener:

Удаление обработчика события DOM-элемента.

Аргументы:

Имя Тип Описание
element Node DOM-элемент, обработчик события которого нужно удалить.
type string Тип обрабатываемого события.
handler function(Event) Функция-обработчик события.

[static] removeOneEventListener:

Удаление единовременного обработчика события.

Аргументы:

Имя Тип Описание
element Node DOM-элемент, единовременный обработчик события которого нужно удалить.
type string Тип обрабатываемого события.
handler function(Event) Функция-обработчик события.

См. также:

[static] select:Array.

Поиск элементов с помощью CSS-селектора в определенном контексте.

Аргументы:

Имя Тип Описание
selector string CSS-селектор которому должны соответсвовать найденные элементы.
opt_context Node Контекст поиска - DOM-элемент в котором должен производиться поиск элементов.

Возвращает:

  • Массив найденных элементов.

[static] selectOne:Node

Поиск единственного элемента соответсующего CSS-селектору.

Аргументы:

Имя Тип Описание
selector string CSS-селектор которому должны соответсвовать найденный элемент.
opt_context Node Контекст поиска - DOM-элемент в котором должен производиться поиск элемента.

Возвращает:

  • Найденный элемент.

[static] setClassExist:

Установка наличия CSS-класса у DOM-элемента.

Аргументы:

Имя Тип Описание
element Node DOM-элемент наличие CSS-класса которого необходимо установить.
className string CSS-класс наличие которого необходимо установить.
isExist boolean Флаг наличия CSS-класса.

[static] setSelectorEngine:

Установка движка поиска элементов с помощью CSS-селекторов. Объект установленный с помощью этой функции используется во многих функциях работающих с DOM-моделью. Интерфейс устанавливаемого объекта должен соответсвовать внешнему интерфейсу класса Sizzle. В случае если движок не установлен, методы, которые его используют возвратят пустой результат при вызове.

Аргументы:

Имя Тип Описание
engine * Движок CSS-селекторов.

См. также:

[static] stopPropagation:

Кросс-браузерная обертка остановки распространения события.

Аргументы:

Имя Тип Описание
event Event Объект DOM-события.

Tuna Framework 2012