Блок предоставляет объект, содержащий набор методов для работы с DOM-деревом.
| Имя | Возвращаемое значение | Описание |
|---|---|---|
contains({jQuery} ctx,{jQuery} domElem) |
{Boolean} |
Проверяет, содержит ли один DOM-элемент другой. |
getFocused({jQuery} domElem) |
{jQuery} |
Служит для получения ссылки на DOM-элемент в фокусе. |
containsFocus({jQuery} domElem) |
{Boolean} |
Проверят, содержит ли DOM-элемент или его потомки фокус. |
isFocusable({jQuery} domElem) |
{Boolean} |
Проверят, может ли DOM-элемент находиться в фокусе. |
isEditable({jQuery} domElem) |
{Boolean} |
Проверят, возможен ли в DOM-элементе ввод текста. |
Блок реализован в технологиях:
jscontainsМетод позволяет проверить содержит ли некоторый 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
});