dom

Блок предоставляет объект, содержащий набор методов для работы с DOM-деревом.

Обзор

Свойства и методы объекта

Публичные технологии блока

Блок реализован в технологиях:

• js

Описание

Свойства и методы объекта

Метод contains

Метод позволяет проверить содержит ли некоторый DOM-элемент ctx элемент domElem.

Принимаемые аргументы:

• ctx {jQuery} – DOM-элемент внутри которого производится поиск. Обязательный аргумент.
• domElem {jQuery} – искомый DOM-элемент. Обязательный аргумент.

Возвращаемое значение: Boolean. Если искомый элемент найден – true.

Пример:

modules.require(['dom', 'jquery'], function(dom, $) {

/*
<div class="block1">
  <div class="block2"></div>
</div>
*/

dom.contains($('.block1'), $('.block2'));  // true

});

Метод getFocused

Метод служит для получения ссылки на DOM-элемент, находящийся в фокусе.

Не принимает аргументов.

Возвращаемое значение: jQuery – объект в фокусе.

Пример:

modules.require(['dom'], function(dom) {

dom.getFocused(); // ссылка на элемент в фокусе

});

Метод containsFocus

Метод проверяет находится ли в фокусе переданный аргументом DOM-элемент или один из его потомков.

Принимаемые аргументы:

• domElem {jQuery} – проверяемый DOM-элемент. Обязательный аргумент.

Возвращаемое значение: Boolean. Если искомый элемент в фокусе – true.

Пример:

modules.require(['dom', 'jquery'], function(dom, $) {

/*
<div class="block1">
  <input class="block1__control"></div>
</div>
*/

$('.block1__control').focus();
dom.containsFocus($('.block1'));  // true

});

Метод isFocusable

Метод проверят может ли браузер пользователя установить фокус на переданный аргументом DOM-элемент.

Принимаемые аргументы:

• domElem {jQuery} – проверяемый DOM-элемент. Обязательный аргумент. Если в jQuery-цепочке несколько DOM-элементов, то проверяется первый из них.

Возвращаемое значение: Boolean. Если фокус может быть установлен – true.

Пример:

modules.require(['dom', 'jquery'], function(dom, $) {

/*
<div class="menu">
  <a class="menu__item" href="/">Link 1</a>
</div>
*/

dom.isFocusable($('.menu__item')); // true

/*
<div class="menu">
  <span class="menu__item menu__item_current">Link 1</span>
</div>
*/

dom.isFocusable($('.menu__item')); // false

});

Метод isEditable

Метод проверят возможен ли в переданном аргументом DOM-элементе ввод текста. Другими словами, с помощью метода можно проверить является ли элемент полем ввода, текстовой областью и т.п.

Принимаемые аргументы:

• domElem {jQuery} – проверяемый DOM-элемент. Обязательный аргумент. Если в jQuery-цепочке несколько DOM-элементов, то проверяется первый из них.

Возвращаемое значение: Boolean. Если ввод текста в элементе возможен – true.

Пример:

modules.require(['dom', 'jquery'], function(dom, $) {

dom.isEditable($('input, textarea')); // true

});