<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
lang="en" dir="ltr">
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><link rel="stylesheet" href="../codebase/default.css" type="text/css" media="screen" title="no title" charset="utf-8"><title>
dhtmlxtree:nodes_manipulation [DHX documentation]
</title></head>
<body>
<div class="dokuwiki">
<div class="stylehead">
<div class="header">
<a class="logo" href="http://dhtmlx.com" title="DHTMLX Home Page"></a>
<span class="tittle-dhtmlx">DHTMLX Docs & Samples Explorer</span>
<div class="search-field">
<form action="/dhtmlx/docs/doku.php" accept-charset="utf-8" id="dw__search"><div class="no"><input type="hidden" name="do" value="search" /><input type="text" id="qsearch__in" accesskey="f" name="id" title="Search" /><button type="submit"></button><div id="qsearch__out" class="ajax_qsearch JSpopup"></div></div></form> </div>
<div class="buttons">
<a class="doc"></a>
<a title="DHTMLX Samples homepage" href="../samples.html" class="sample"/></a>
</div>
<!-- <div class="pagename">
[[<a href="#" title="Backlinks">dhtmlxtree:nodes_manipulation</a>]]
</div>
<div class="logo">
<a href="/dhtmlx/docs/doku.php" name="dokuwiki__top" id="dokuwiki__top" accesskey="h" title="[H]">DHX documentation</a> </div>
<div class="clearer"></div>-->
</div>
<!-- <div class="bar" id="bar__top">
<div class="bar-left" id="bar__topleft">
<form class="button btn_edit" method="post" action="/dhtmlx/docs/doku.php"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="" /><input type="hidden" name="id" value="dhtmlxtree:nodes_manipulation" /><input type="submit" value="Edit this page" class="button" accesskey="e" title="Edit this page [E]" /></div></form> <form class="button btn_revs" method="get" action="/dhtmlx/docs/doku.php"><div class="no"><input type="hidden" name="do" value="revisions" /><input type="hidden" name="id" value="dhtmlxtree:nodes_manipulation" /><input type="submit" value="Old revisions" class="button" accesskey="o" title="Old revisions [O]" /></div></form> </div>
<div class="bar-right" id="bar__topright">
<form class="button btn_recent" method="get" action="/dhtmlx/docs/doku.php"><div class="no"><input type="hidden" name="do" value="recent" /><input type="hidden" name="id" value="dhtmlxtree:nodes_manipulation" /><input type="submit" value="Recent changes" class="button" accesskey="r" title="Recent changes [R]" /></div></form> <form action="/dhtmlx/docs/doku.php" accept-charset="utf-8" id="dw__search"><div class="no"><input type="hidden" name="do" value="search" /><input type="text" id="qsearch__in" accesskey="f" name="id" title="Search" /><button type="submit"></button><div id="qsearch__out" class="ajax_qsearch JSpopup"></div></div></form>
</div>
<div class="clearer"></div>
</div> -->
<!-- <div class="breadcrumbs">
<span class="bchead">Trace:</span> <span class="bcsep">»</span> <span class="curid"><a href="/dhtmlx/docs/doku.php?id=dhtmlxtree:nodes_manipulation" class="breadcrumbs" title="dhtmlxtree:nodes_manipulation">nodes_manipulation</a></span> </div>
-->
</div>
<div class="page">
<!-- wikipage start -->
<!-- TOC START -->
<div class="toc">
<div class="tocheader toctoggle" id="toc__header">Table of Contents</div>
<div id="toc__inside">
<ul class="toc">
<li class="clear">
<ul class="toc">
<li class="level2"><div class="li"><span class="li"><a href="#nodes_manipulation" class="toc">Nodes Manipulation</a></span></div>
<ul class="toc">
<li class="level3"><div class="li"><span class="li"><a href="#adding_removing_items" class="toc">Adding/Removing Items</a></span></div></li>
<li class="level3"><div class="li"><span class="li"><a href="#collapsing_expanding_items" class="toc">Collapsing/Expanding Items</a></span></div></li>
<li class="level3"><div class="li"><span class="li"><a href="#editing_item" class="toc">Editing Item</a></span></div></li>
<li class="level3"><div class="li"><span class="li"><a href="#integration_with_cookies" class="toc">Integration with Cookies</a></span></div></li>
<li class="level3"><div class="li"><span class="li"><a href="#item_text_tooltip_color_manipulation" class="toc">Item Text, Tooltip, Color Manipulation</a></span></div></li>
<li class="level3"><div class="li"><span class="li"><a href="#refreshing_and_updating_items" class="toc">Refreshing and Updating Items</a></span></div></li>
<li class="level3"><div class="li"><span class="li"><a href="#items_ids_manipulation" class="toc">Items Ids Manipulation</a></span></div></li>
<li class="level3"><div class="li"><span class="li"><a href="#items_position_manipulation" class="toc">Items Position Manipulation</a></span></div></li>
<li class="level3"><div class="li"><span class="li"><a href="#calculating_items" class="toc">Calculating Items</a></span></div></li>
<li class="level3"><div class="li"><span class="li"><a href="#user_data_manipulation" class="toc">User Data Manipulation</a></span></div></li>
<li class="level3"><div class="li"><span class="li"><a href="#using_link-like_functionality_in_tree" class="toc">Using Link-Like Functionality in Tree</a></span></div></li></ul>
</li></ul>
</li></ul>
</div>
</div>
<!-- TOC END -->
<p>
<div class='backlinks'><div class='backlink last_backlink'><img src="icons___file.gif" class="media" alt="" /><a href="../index.html" class="wikilink1" title="start">Index</a></div><div class='arrow'></div><div class='backlink last_backlink'><img src="icons___tree.gif" class="media" alt="" /><a href="index.html" class="wikilink1" title="dhtmlxtree:toc">dhtmlxtree</a></div></div>
</p>
<h2><a name="nodes_manipulation" id="nodes_manipulation">Nodes Manipulation</a></h2>
<div class="level2">
</div>
<div class="secedit"><form class="button btn_secedit" method="post" action="/dhtmlx/docs/doku.php"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="lines" value="53-87" /><input type="hidden" name="rev" value="1335526056" /><input type="hidden" name="id" value="dhtmlxtree:nodes_manipulation" /><input type="submit" value="Edit" class="button" title="Nodes Manipulation" /></div></form></div>
<h3><a name="adding_removing_items" id="adding_removing_items">Adding/Removing Items</a></h3>
<div class="level3">
</div>
<h4><a name="adding_parent_item" id="adding_parent_item">Adding Parent Item</a></h4>
<div class="level4">
<p>
Parent tree nodes can be easily added to the tree from script with the help of insertNewNext() method. The following incoming parameters should be indicated in this method:
</p>
<ul>
<li class="level1"><div class="li"> siblingId - id of the item after which the new one will be created;</div>
</li>
<li class="level1"><div class="li"> itemId - id of the new item;</div>
</li>
<li class="level1"><div class="li"> label - text of the new item;</div>
</li>
<li class="level1"><div class="li"> action - 0 in most cases, but can be a custom function;</div>
</li>
<li class="level1"><div class="li"> imageClosed - image for a collapsed item; if 0 is indicated - the default one is used;</div>
</li>
<li class="level1"><div class="li"> imageOpen - image for an expanded item; if 0 is indicated - the default one is used;</div>
</li>
<li class="level1"><div class="li"> imageLeaf - image for a leaf item; if 0 is indicated - the default one is used;</div>
</li>
<li class="level1"><div class="li"> additional options - a comma delimited string of the following possible values (upper case only):</div>
<ul>
<li class="level2"><div class="li"> SELECT - move selection to thi