improvement

Author: iliakan

3-webcomponents/7-webcomponent-build/article.md

@@ -272,9 +272,11 @@ if(!jQuery.contains(elem.ownerDocument, elem)) {
 }
 ```
 
-То есть, jQuery проверяет, находится ли элемент внутри своего документа. Если нет -- оно считает, что элемент не в DOM, и его размеры равны нулю.
+То есть, jQuery проверяет, находится ли элемент `elem` внутри своего документа `elem.ownerDocument`. Если нет -- то считается, что элемент вне DOM, и его размеры равны нулю. 
 
-**Но в случае с Shadow DOM элемент как раз *не* лежит в `document`. Вызов `document.contains(elem)` вернёт `false`!**
+Если копнуть чуть глубже, то `jQuery.contains` в современных браузерах сводится к обычному вызову [contains](https://developer.mozilla.org/en-US/docs/Web/API/Node/contains).
+
+Парадокс с Shadow DOM заключается в том, что вызов `elem.ownerDocument.contains(elem)` вернёт `false`!
 
 Получилось, что элемент не в документе и одновременно он имеет размеры. Такого разработчики jQuery не предусмотрели.
 
@@ -284,9 +286,11 @@ if(!jQuery.contains(elem.ownerDocument, elem)) {
 
 Поэтому на самом деле `document.contains(elem)` следовало бы возвращать `true`.
 
-Почему же `false`? Причина проста -- описанный в [другом стандарте](http://www.w3.org/TR/dom/#dom-node-contains) механизм работы `contains` по сути состоит в проходе вверх от `elem` по цепочке `parentNode`, пока либо встретим искомый элемент, тогда ответ `true`, а иначе `false`. В случае с Shadow DOM этот путь закончится на корне Shadow DOM-дерева, оно ведь не является потомком хозяина. Метод `contains` не знает ничего про саму возможность Shadow DOM, поэтому и выходит, что результат `false`.
+Почему же `false`? Причина проста -- описанный в [другом стандарте](http://www.w3.org/TR/dom/#dom-node-contains) механизм работы `contains` по сути состоит в проходе вверх от `elem` по цепочке `parentNode`, пока либо встретим искомый элемент, тогда ответ `true`, а иначе `false`. В случае с Shadow DOM этот путь закончится на корне Shadow DOM-дерева, оно ведь не является потомком хозяина. 
+
+**Метод `contains` описан стандартом без учёта Shadow DOM, поэтому возвратил неверный результат `false`.**
 
-Это один из тех небольших, но важных нюансов, которые показывают, почему стандарты всё ещё в разработке.
+Это один из тех небольших, но важных нюансов, которые показывают, что стандарты всё ещё в разработке.
 
 ## Итого