diff options
Diffstat (limited to 'files/ru/web/api/node/appendchild/index.html')
| -rw-r--r-- | files/ru/web/api/node/appendchild/index.html | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/files/ru/web/api/node/appendchild/index.html b/files/ru/web/api/node/appendchild/index.html new file mode 100644 index 0000000000..50af4e38da --- /dev/null +++ b/files/ru/web/api/node/appendchild/index.html @@ -0,0 +1,60 @@ +--- +title: Node.appendChild +slug: Web/API/Node/appendChild +tags: + - API + - DOM + - DOM Element Mehods + - Method + - WebAPI +translation_of: Web/API/Node/appendChild +--- +<h2 id="Summary" name="Summary">Аннотация</h2> + +<p><code><strong>Node.appendChild()</strong></code> добавляет узел в конец списка дочерних элементов указанного родительского узла. Если данный дочерний элемент является ссылкой на существующий узел в документе, то функция <code>appendChild()</code> перемещает его из текущей позиции в новую позицию (нет необходимости удалять узел из родительского узла перед добавлением его к какому-либо другому узлу).</p> + +<p>Это означает, что узел не может находиться в двух точках документа одновременно. Поэтому, если у узла уже есть родитель, он сначала удаляется, а затем добавляется в новую позицию. {{domxref("Node.cloneNode()")}} можно использовать для создания копии узла перед добавлением его в новый родительский элемент. Обратите внимание, что копии, сделанные с помощью <code>cloneNode</code> , не будут автоматически синхронизироваться.</p> + +<p>Если данный дочерний элемент является {{domxref("DocumentFragment")}}, то все содержимое {{domxref("DocumentFragment")}} перемещается в дочерний список указанного родительского узла.</p> + +<h2 id="Syntax" name="Syntax">Синтаксис</h2> + +<pre class="syntaxbox notranslate">var child = <em>element</em>.appendChild(<em>child</em>);</pre> + +<ul> + <li><code>element</code> родительский <a href="/en-US/docs/DOM/element" title="/en-US/docs/DOM/element">элемент</a>.</li> + <li><code>child</code> это элемент вставляется в конец <code>element</code>.</li> +</ul> + +<h3 id="Returns" name="Returns">Возвращаемое значение</h3> + +<p>Возвращается дочерний элемент (<code><var>aChild</var></code>), кроме тех случаев, когда <code><var>child</var></code> это {{domxref("DocumentFragment")}}, в таком случае возвращается пустой {{domxref("DocumentFragment")}}.</p> + +<h2 id="Notes" name="Notes">Примечание</h2> + +<p>Цепочка может работать не так, как ожидалось, из-за того, что <code>appendChild()</code> возвращает дочерний элемент:</p> + +<pre class="brush: js notranslate">let aBlock = document.createElement('block').appendChild( document.createElement('b') );</pre> + +<p>Присваивает переменной <code>aBlock</code> элемент <code><b></b></code>, а не <code><block></block></code>, как вы могли ожидать.</p> + +<h2 id="Example" name="Example">Пример</h2> + +<pre class="brush:js notranslate">// Создаем новый элемент параграфа, и вставляем в конец document body +var p = document.createElement("p"); +document.body.appendChild(p);</pre> + +<h2 id="Specification" name="Specification">Спецификация</h2> + +<ul> + <li><a class="external" href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-184E7107" title="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-184E7107">DOM Level 3 Core: appendChild</a></li> +</ul> + +<h2 id="See_also" name="See_also">См. также</h2> + +<ul> + <li>{{domxref("Node.removeChild")}}</li> + <li>{{domxref("Node.replaceChild")}}</li> + <li>{{domxref("Node.insertBefore")}}</li> + <li>{{domxref("Node.hasChildNodes")}}</li> +</ul> |