initial commit

1 files changed, 157 insertions, 0 deletions

diff --git a/files/ru/web/api/element/matches/index.html b/files/ru/web/api/element/matches/index.html
new file mode 100644
index 0000000000..a8fe49cccb
--- /dev/null
+++ b/files/ru/web/api/element/matches/index.html
@@ -0,0 +1,157 @@
+---
+title: Element.matches()
+slug: Web/API/Element/matches
+translation_of: Web/API/Element/matches
+---
+<p>{{ APIRef("DOM") }}</p>
+
+<h2 id="Summary" name="Summary">Описание</h2>
+
+<p>Метод <strong><code>Element.matches()</code></strong> вернёт <code>true</code> или false, в зависимости от того, соответствует ли элемент указанному css-селектору.</p>
+
+<div class="warning">
+<p>В некоторых браузерах данный метод имеет нестандартное название - <code>matchesSelector()</code>.</p>
+</div>
+
+<h2 id="Syntax" name="Syntax">Синтаксис</h2>
+
+<pre class="syntaxbox"><em>var result</em> = <em>element</em>.matches(selectorString)
+</pre>
+
+<ul>
+ <li><code>Результат выполнения - <strong>true</strong> или <strong>false</strong>.</code></li>
+ <li><strong><code>selectorString</code></strong> - строка, содержащая любой css-селектор, к примеру:<em> <strong>"div"</strong></em>,<em> <strong>"*"</strong></em>,<em> <strong>"#id"</strong></em> и прочие.</li>
+</ul>
+
+<h2 id="Example" name="Example">Пример</h2>
+
+<pre class="brush: html">&lt;div id="one"&gt;Первый подопытный&lt;/div&gt;
+&lt;div class="someClass" id="two"&gt;Второй подопытный&lt;/div&gt;
+
+&lt;script type="text/javascript"&gt;
+
+  var coll = document.querySelectorAll("div");
+  for (var i = 0, len = coll.length; i &lt; len; i++) {
+    if (coll[i].matches(".someClass")) {
+      alert(coll[i].id+": Я выжил!");
+    }else{
+      coll[i].remove();
+    }
+  }
+
+&lt;/script&gt;
+</pre>
+
+<p>Вызов alert сработает только для второго элемента div, которому присвоен класс "someClass".</p>
+
+<h2 id="Исключения">Исключения</h2>
+
+<dl>
+ <dt><code>SYNTAX_ERR</code></dt>
+ <dd>Указаный css-селектор не является допустимым<em> ("/=22=1", "&amp;@*#", "%%''23" и т.п приведут к ошибке).</em></dd>
+</dl>
+
+<h2 id="Полифилл">Полифилл</h2>
+
+<p>Полифил будет работать только в браузерах, поддерживающих метод document.queryselectorAll.</p>
+
+<pre class="brush: js">;(function(e) {
+    var matches = e.matches || e.matchesSelector || e.webkitMatchesSelector || e.mozMatchesSelector || e.msMatchesSelector || e.oMatchesSelector;
+    !matches ? (e.matches = e.matchesSelector = function matches(selector) {
+        var matches = document.querySelectorAll(selector);
+        var th = this;
+        return Array.prototype.some.call(matches, function(e) {
+            return e === th;
+        });
+    }) : (e.matches = e.matchesSelector = matches);
+})(Element.prototype);</pre>
+
+<h2 id="sect1"> </h2>
+
+<h2 id="Спецификация">Спецификация</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">Спецификация</th>
+   <th scope="col">Статус</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('DOM WHATWG', '#dom-element-matches', 'Element.prototype.matches')}}</td>
+   <td>{{Spec2('DOM WHATWG')}}</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Поддержка_браузерами">Поддержка браузерами</h2>
+
+<p>{{CompatibilityTable}}</p>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+  <tr>
+   <th>Особенность</th>
+   <th>Chrome</th>
+   <th>Firefox (Gecko)</th>
+   <th>Internet Explorer</th>
+   <th>Opera</th>
+   <th>Safari (WebKit)</th>
+  </tr>
+  <tr>
+   <td>Поддерживается , но имеет иное название</td>
+   <td>
+    <p>{{CompatVersionUnknown}} имеет название  <code>webkitMatchesSelector</code></p>
+   </td>
+   <td>{{CompatGeckoDesktop("1.9.2")}} имеет название   <code>mozMatchesSelector</code> [1]</td>
+   <td>9.0 имеет название <code>msMatchesSelector</code></td>
+   <td>11.5 имеет название  <code>oMatchesSelector</code>,<br>
+    а с 15.0 - <code>webkitMatchesSelector</code></td>
+   <td>5.0 известен под названием <code>webkitMatchesSelector</code></td>
+  </tr>
+  <tr>
+   <td>Unprefix version</td>
+   <td>{{CompatChrome("34")}}</td>
+   <td>{{CompatGeckoDesktop("34")}}</td>
+   <td>{{CompatUnknown}}</td>
+   <td>{{CompatUnknown}}</td>
+   <td>7.1</td>
+  </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+  <tr>
+   <th>Особенность</th>
+   <th>Android</th>
+   <th>Firefox Mobile (Gecko)</th>
+   <th>IE Phone</th>
+   <th>Opera Mobile</th>
+   <th>Safari Mobile</th>
+  </tr>
+  <tr>
+   <td>Поддерживается , но имеет иное название</td>
+   <td>{{CompatUnknown}}</td>
+   <td>{{CompatGeckoMobile("1.9.2")}} имеет название <code>mozMatchesSelector</code> [1]</td>
+   <td>{{CompatUnknown}}</td>
+   <td>{{CompatUnknown}}</td>
+   <td>{{CompatUnknown}}</td>
+  </tr>
+  <tr>
+   <td>Unprefix version</td>
+   <td>{{CompatUnknown}}</td>
+   <td>{{CompatGeckoMobile("34")}}</td>
+   <td>{{CompatUnknown}}</td>
+   <td>{{CompatUnknown}}</td>
+   <td>8</td>
+  </tr>
+ </tbody>
+</table>
+</div>
+
+<p> До появления Gecko 2.0 вызов с недопустимым селектором возвращал  <code>false</code>, а не вызывал исключение...</p>