Блок предоставляет объект, содержащий набор методов для работы с 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-элементе ввод текста. |
Блок реализован в технологиях:
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
});