\n*/\n\ndom.contains($('.block1'), $('.block2')); // true\n\n});\n```\n\n\n\n#### `getFocused` method\n\nGets a reference to the DOM element that is in focus.\n\nDoesn't accept arguments.\n\n**Return value:** `jQuery` – The object in focus.\n\nExample:\n\n```js\nmodules.require(['dom'], function(dom) {\n\ndom.getFocused(); // a reference to the element in focus\n\n});\n```\n\n\n\n#### `containsFocus` method\n\nThis method checks whether the focus is on the DOM element passed in the argument or one of its descendants.\n\n**Accepted arguments:**\n\n* `domElem {jQuery}` – The DOM element to check. Required argument.\n\n**Return value:** `Boolean`. If this element is in focus, then `true`.\n\nExample:\n\n```js\nmodules.require(['dom', 'jquery'], function(dom, $) {\n\n/*\n
\n
\n\n*/\n\n$('.block1__control').focus();\ndom.containsFocus($('.block1')); // true\n\n});\n```\n\n\n\n#### `isFocusable` method\n\nThis method checks whether the user's browser can set the focus on the DOM element passed in the argument. \n\n**Accepted arguments:**\n\n* `domElem {jQuery}` – The DOM element to check. Required argument. If there are mutiple DOM elements in the jQuery chain, the first one is checked.\n\n**Return value:** `Boolean`. If the focus can be set on this element, then `true`.\n\nExample:\n\n```js\nmodules.require(['dom', 'jquery'], function(dom, $) {\n\n/*\n
\n*/\n\ndom.isFocusable($('.menu__item')); // false\n\n});\n```\n\n\n\n#### `isEditable` method\n\nThis method checks whether text can be entered in the DOM element passed in the argument. In other words, you can use this method to check whether the element is an input field, text field, and so on.\n\n**Accepted arguments:**\n\n* `domElem {jQuery}` – The DOM element to check. Required argument. If there are mutiple DOM elements in the jQuery chain, the first one is checked.\n\n**Return value:** `Boolean`. If text can be entered in the DOM element, then `true`.\n\nExample:\n\n```js\nmodules.require(['dom', 'jquery'], function(dom, $) {\n\ndom.isEditable($('input, textarea')); // true\n\n});\n```\n"
},
{
"path": "common.blocks/dom/dom.js",
"content": "/**\n * @module dom\n * @description some DOM utils\n */\n\nimport $ from 'bem:jquery'\n\nconst EDITABLE_INPUT_TYPES = new Set([\n 'datetime-local',\n 'date',\n 'month',\n 'number',\n 'password',\n 'search',\n 'tel',\n 'text',\n 'time',\n 'url',\n 'week'\n])\n\nexport default {\n /**\n * Checks whether a DOM elem is in a context\n * @param {jQuery} ctx DOM elem where check is being performed\n * @param {jQuery} domElem DOM elem to check\n * @returns {Boolean}\n */\n contains(ctx, domElem) {\n let res = false\n\n domElem.each(function() {\n let domNode = this\n do {\n if(~ctx.index(domNode)) return !(res = true)\n } while(domNode = domNode.parentNode)\n\n return res\n })\n\n return res\n },\n\n /**\n * Returns current focused DOM elem in document\n * @returns {jQuery}\n */\n getFocused() {\n // \"Error: Unspecified error.\" in iframe in IE9\n try { return $(document.activeElement) } catch(e) {}\n },\n\n /**\n * Checks whether a DOM element contains focus\n * @param {jQuery} domElem\n * @returns {Boolean}\n */\n containsFocus(domElem) {\n return this.contains(domElem, this.getFocused())\n },\n\n /**\n * Checks whether a browser currently can set focus on DOM elem\n * @param {jQuery} domElem\n * @returns {Boolean}\n */\n isFocusable(domElem) {\n const domNode = domElem[0]\n\n if(!domNode) return false\n if(domNode.hasAttribute('tabindex')) return true\n\n switch(domNode.tagName.toLowerCase()) {\n case 'iframe':\n return true\n\n case 'input':\n case 'button':\n case 'textarea':\n case 'select':\n return !domNode.disabled\n\n case 'a':\n return !!domNode.href\n }\n\n return false\n },\n\n /**\n * Checks whether a domElem is intended to edit text\n * @param {jQuery} domElem\n * @returns {Boolean}\n */\n isEditable(domElem) {\n const domNode = domElem[0]\n\n if(!domNode) return false\n\n switch(domNode.tagName.toLowerCase()) {\n case 'input':\n return EDITABLE_INPUT_TYPES.has(domNode.type) && !domNode.disabled && !domNode.readOnly\n\n case 'textarea':\n return !domNode.disabled && !domNode.readOnly\n\n default:\n return domNode.contentEditable === 'true'\n }\n }\n}\n"
},
{
"path": "common.blocks/dom/dom.ru.md",
"content": "# dom\n\nБлок предоставляет объект, содержащий набор методов для работы с DOM-деревом.\n\n## Обзор\n\n### Свойства и методы объекта\n\n| Имя | Тип возвращаемого значения | Описание |\n| -------- | --- | -------- |\n| contains( `ctx {jQuery}`, `domElem {jQuery}`) | `Boolean` | Проверяет, содержит ли один DOM-элемент другой. |\n| getFocused( `domElem {jQuery} `) | `jQuery` | Служит для получения ссылки на DOM-элемент в фокусе. |\n| containsFocus( `domElem {jQuery} `) | `Boolean` | Проверят, содержит ли DOM-элемент или его потомки фокус. |\n| isFocusable( `domElem {jQuery} `) | `Boolean` | Проверят, может ли DOM-элемент находиться в фокусе. |\n| isEditable( `domElem {jQuery}`) | `Boolean` | Проверят, возможен ли в DOM-элементе ввод текста. |\n\n### Публичные технологии блока\n\nБлок реализован в технологиях:\n\n* `js`\n\n## Описание\n\n\n\n### Свойства и методы объекта\n\n\n\n#### Метод `contains`\n\nМетод позволяет проверить содержит ли некоторый DOM-элемент `ctx` элемент `domElem`.\n\n**Принимаемые аргументы:**\n\n* `ctx {jQuery}` – DOM-элемент внутри которого производится поиск. Обязательный аргумент.\n* `domElem {jQuery}` – искомый DOM-элемент. Обязательный аргумент.\n\n**Возвращаемое значение:** `Boolean`. Если искомый элемент найден – `true`.\n\nПример:\n\n```js\nmodules.require(['dom', 'jquery'], function(dom, $) {\n\n/*\n
\n \n
\n*/\n\ndom.contains($('.block1'), $('.block2')); // true\n\n});\n```\n\n\n\n#### Метод `getFocused`\n\nМетод служит для получения ссылки на DOM-элемент, находящийся в фокусе.\n\nНе принимает аргументов.\n\n**Возвращаемое значение:** `jQuery` – объект в фокусе.\n\nПример:\n\n```js\nmodules.require(['dom'], function(dom) {\n\ndom.getFocused(); // ссылка на элемент в фокусе\n\n});\n```\n\n\n\n#### Метод `containsFocus`\n\nМетод проверяет находится ли в фокусе переданный аргументом DOM-элемент или один из его потомков.\n\n**Принимаемые аргументы:**\n\n* `domElem {jQuery}` – проверяемый DOM-элемент. Обязательный аргумент.\n\n**Возвращаемое значение:** `Boolean`. Если искомый элемент в фокусе – `true`.\n\nПример:\n\n```js\nmodules.require(['dom', 'jquery'], function(dom, $) {\n\n/*\n
\n
\n\n*/\n\n$('.block1__control').focus();\ndom.containsFocus($('.block1')); // true\n\n});\n```\n\n\n\n#### Метод `isFocusable`\n\nМетод проверят может ли браузер пользователя установить фокус на переданный аргументом DOM-элемент. \n\n**Принимаемые аргументы:**\n\n* `domElem {jQuery}` – проверяемый DOM-элемент. Обязательный аргумент. Если в jQuery-цепочке несколько DOM-элементов, то проверяется первый из них.\n\n**Возвращаемое значение:** `Boolean`. Если фокус может быть установлен – `true`.\n\nПример:\n\n```js\nmodules.require(['dom', 'jquery'], function(dom, $) {\n\n/*\n
\n*/\n\ndom.isFocusable($('.menu__item')); // false\n\n});\n```\n\n\n\n#### Метод `isEditable`\n\nМетод проверят возможен ли в переданном аргументом DOM-элементе ввод текста. Другими словами, с помощью метода можно проверить является ли элемент полем ввода, текстовой областью и т.п.\n\n**Принимаемые аргументы:**\n\n* `domElem {jQuery}` – проверяемый DOM-элемент. Обязательный аргумент. Если в jQuery-цепочке несколько DOM-элементов, то проверяется первый из них.\n\n**Возвращаемое значение:** `Boolean`. Если ввод текста в элементе возможен – `true`.\n\nПример:\n\n```js\nmodules.require(['dom', 'jquery'], function(dom, $) {\n\ndom.isEditable($('input, textarea')); // true\n\n});\n```\n"
},
{
"path": "common.blocks/dom/dom.spec.js",
"content": "modules.define('spec', [\n 'dom',\n 'jquery'\n], function(provide,\n dom,\n $\n) {\n\ndescribe('dom', function() {\n describe('contains', function() {\n var domElem;\n beforeEach(function() {\n domElem = $(\n '
' +\n '
' +\n '
' +\n '
' +\n '
' +\n '
' +\n '
' +\n '
' +\n '
' +\n '
')\n .appendTo('body');\n });\n\n afterEach(function() {\n domElem.remove();\n });\n\n it('should properly checks for nested dom elem', function() {\n dom.contains(domElem.find('.a'), domElem.find('.x')).should.be.true;\n dom.contains(domElem.find('.a'), domElem.find('.y')).should.be.true;\n dom.contains(domElem.find('.c'), domElem.find('.x')).should.be.false;\n });\n\n it('should returns true for itself', function() {\n dom.contains(domElem.find('.x'), domElem.find('.x')).should.be.true;\n });\n\n it('should returns false for empty DOM elem', function() {\n dom.contains(domElem.find('.a'), domElem.find('.no-exist')).should.be.false;\n });\n });\n\n describe('getFocused', function() {\n it('should returns focused DOM elem', function() {\n var elem = $('')\n .appendTo('body')\n .focus();\n dom.getFocused()[0].should.be.eql(elem[0]);\n elem.blur();\n dom.getFocused()[0].should.not.be.eql(elem[0]);\n elem.remove();\n });\n });\n\n describe('isFocusable', function() {\n it('should returns true if given DOM elem is iframe, input, button, textarea or select', function() {\n dom.isFocusable($('')).should.be.true;\n dom.isFocusable($('')).should.be.true;\n dom.isFocusable($('')).should.be.true;\n dom.isFocusable($('')).should.be.true;\n dom.isFocusable($('')).should.be.true;\n });\n\n it('should returns false if given DOM elem is disabled', function() {\n dom.isFocusable($('')).should.be.false;\n dom.isFocusable($('