You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
197 lines
8.2 KiB
197 lines
8.2 KiB
<!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"> |
|
<head> |
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
|
<title>jsTree v.1.0 - UI documentation</title> |
|
<script type="text/javascript" src="../_lib/jquery.js"></script> |
|
<script type="text/javascript" src="../_lib/jquery.cookie.js"></script> |
|
<script type="text/javascript" src="../_lib/jquery.hotkeys.js"></script> |
|
<script type="text/javascript" src="../jquery.jstree.js"></script> |
|
|
|
<link type="text/css" rel="stylesheet" href="syntax/!style.css"/> |
|
<link type="text/css" rel="stylesheet" href="!style.css"/> |
|
<script type="text/javascript" src="syntax/!script.js"></script> |
|
</head> |
|
<body> |
|
<div id="container"> |
|
|
|
<h1 id="dhead">jsTree v.1.0</h1> |
|
<h1>ui plugin</h1> |
|
<h2>Description</h2> |
|
<div id="description"> |
|
<p>The <code>UI</code> plugin handles selecting, deselecting and hovering tree items.</p> |
|
</div> |
|
|
|
<h2 id="configuration">Configuration</h2> |
|
<div class="panel configuration"> |
|
<h3>select_limit</h3> |
|
<p class="meta">A number. Default is <code>-1</code>.</p> |
|
<p>Defines how many nodes can be selected at a given time (<code>-1</code> means unlimited).</p> |
|
|
|
<h3>select_multiple_modifier</h3> |
|
<p class="meta">A string. Default is <code>"ctrl"</code>.</p> |
|
<p>The special key used to make a click add to the selection and not replace it (<code>"ctrl"</code>, <code>"shift"</code>, <code>"alt"</code>, <code>"meta"</code>).<br />You can also set this to <code>"on"</code> making every click add to the selection.</p> |
|
|
|
<h3>select_range_modifier</h3> |
|
<p class="meta">A string. Default is <code>"shift"</code>.</p> |
|
<p>The special key used to make a click expand a range from the last selected item (<code>"ctrl"</code>, <code>"shift"</code>, <code>"alt"</code>, <code>"meta"</code>).<br />Note that the last clicked elemtn should be a sibling of the currently clicked element so that a range will be created (same as common file explorers).</p> |
|
|
|
<h3>selected_parent_close</h3> |
|
<p class="meta">A string (or <code>false</code>). Default is <code>"select_parent"</code>.</p> |
|
<p>What action to take when a selected node's parent is closed (making the selected node invisible). Possible values are <code>false</code> - do nothing, <code>"select_parent"</code> - select the closed node's parent and <code>"deselect"</code> - deselect the node.</p> |
|
|
|
<h3>selected_parent_open</h3> |
|
<p class="meta">A Boolean. Default is <code>true</code>.</p> |
|
<p>When set to <code>true</code> when programatically selecting a node in the tree all of its closed parents are opened automatically.</p> |
|
|
|
<h3>select_prev_on_delete</h3> |
|
<p class="meta">A boolean. Default is <code>true</code>.</p> |
|
<p>If set to <code>true</code> when a selected node is deleted, its previous sibling (or parent) is selected.</p> |
|
|
|
<h3>disable_selecting_children</h3> |
|
<p class="meta">A boolean. Default is <code>false</code>.</p> |
|
<p>If set to <code>true</code> you will not be able to select children of already selected nodes.</p> |
|
|
|
<h3>initially_select</h3> |
|
<p class="meta">An array. Default is <code>[]</code>.</p> |
|
<p>Defines which nodes are to be automatically selected when the tree finishes loading - a list of IDs is expected.</p> |
|
|
|
</div> |
|
|
|
<h2 id="demos">Demos</h2> |
|
<div class="panel"> |
|
|
|
<h3>Using the UI plugin</h3> |
|
<div id="demo1" class="demo"> |
|
<ul> |
|
<li id="phtml_1"> |
|
<a href="#">Root node 1</a> |
|
<ul> |
|
<li id="phtml_2"> |
|
<a href="#">Child node 1</a> |
|
</li> |
|
<li id="phtml_3"> |
|
<a href="#">Child node 2</a> |
|
</li> |
|
</ul> |
|
</li> |
|
<li id="phtml_4"> |
|
<a href="#">Root node 2</a> |
|
</li> |
|
</ul> |
|
</div> |
|
<script type="text/javascript" class="source"> |
|
$(function () { |
|
$("#demo1").jstree({ |
|
"ui" : { |
|
"select_limit" : 2, |
|
"select_multiple_modifier" : "alt", |
|
"selected_parent_close" : "select_parent", |
|
"initially_select" : [ "phtml_2" ] |
|
}, |
|
"core" : { "initially_open" : [ "phtml_1" ] }, |
|
"plugins" : [ "themes", "html_data", "ui" ] |
|
}); |
|
}); |
|
</script> |
|
|
|
</div> |
|
|
|
<h2 id="api">API</h2> |
|
<div class="panel api"> |
|
|
|
<h3 id="_get_node">._get_node ( node , allow_multiple )</h3> |
|
<p>Overrides the function from the <a href="core.html#_get_node">core</a> module.<br />if <code>node</code> is <code>undefined</code> or <code>null</code> and <code>allow_multiple</code> is <code>true</code> all the currently selected nodes are returned<br />if <code>node</code> is <code>undefined</code> or <code>null</code> and <code>allow_multiple</code> is NOT <code>true</code> only the last selected node is returned.</p> |
|
<ul class="arguments"> |
|
<li> |
|
<code class="tp">mixed</code> <strong>node</strong> |
|
<p>This can be a DOM node, jQuery node or selector pointing to an element within the tree.</p> |
|
</li> |
|
<li> |
|
<code class="tp">boolean</code> <strong>allow_multiple</strong> |
|
<p>Whether to return all selected nodes or only the last selected one if <code>node</code> is <code>null</code>.</p> |
|
</li> |
|
</ul> |
|
|
|
<h3 id="save_selected">.save_selected ( )</h3> |
|
<p>Saves away the current selection state of the tree (saves it in a variable, so do not expect a restore after a refresh - for that functionality refer to the <a href="cookies.html">cookies plugin</a>. Used mostly internally. Triggers an event.</p> |
|
|
|
<h3 id="reselect">.reselect ( )</h3> |
|
<p>Restores the state of the tree using the variable saved in the above function. Used mostly internally. Triggers an event.</p> |
|
|
|
<h3 id="refresh">.refresh ( node )</h3> |
|
<p>Overrides the function form the <a href="core.html#refresh">core</a> module.<br />Enables saving the selection state before the refresh and restoring it afterwards.</p> |
|
|
|
<h3 id="hover_node">.hover_node ( node )</h3> |
|
<p>Sets the specified node as hovered. Triggers an event.</p> |
|
<ul class="arguments"> |
|
<li> |
|
<code class="tp">mixed</code> <strong>node</strong> |
|
<p>This can be a DOM node, jQuery node or selector pointing to an element within the tree.</p> |
|
</li> |
|
</ul> |
|
|
|
<h3 id="dehover_node">.dehover_node ( )</h3> |
|
<p>Removes the hover state from the currently hovered node (if there is one). Triggers an event.</p> |
|
|
|
|
|
<h3 id="select_node">.select_node ( node , check , event )</h3> |
|
<ul class="arguments"> |
|
<li> |
|
<code class="tp">mixed</code> <strong>node</strong> |
|
<p>This can be a DOM node, jQuery node or selector pointing to an element within the tree.</p> |
|
</li> |
|
<li> |
|
<code class="tp">bool</code> <strong>check</strong> |
|
<p>Whether to check the specified rules and do appropriate actions (check <code>select_limit</code>, deselect other nodes respectively, etc) or to just force selection of the node regardless of <code>select_limit</code>.</p> |
|
</li> |
|
<li> |
|
<code class="tp">event</code> <strong>event</strong> |
|
<p>Used internally - when a click on a node caused this function to be executed.</p> |
|
</li> |
|
</ul> |
|
|
|
<div style="height:1px; visibility:hidden; overflow:hidden;"><span id="toggle_select"> </span></div> |
|
<h3 id="deselect_node">.deselect_node ( node ), .toggle_select ( node )</h3> |
|
<p>There functions control the selected state on a node. <code>deselect_node</code> triggers an event.</p> |
|
<ul class="arguments"> |
|
<li> |
|
<code class="tp">mixed</code> <strong>node</strong> |
|
<p>This can be a DOM node, jQuery node or selector pointing to an element within the tree.</p> |
|
</li> |
|
</ul> |
|
|
|
<h3 id="deselect_all">.deselect_all ( context )</h3> |
|
<p>Deselects all selected nodes. If context is set - only the selected nodes within that context are deselected. Triggers an event.</p> |
|
<ul class="arguments"> |
|
<li> |
|
<code class="tp">mixed</code> <strong>context</strong> |
|
<p>This can be a DOM node, jQuery node or selector pointing to an element within the tree.</p> |
|
</li> |
|
</ul> |
|
|
|
<h3 id="get_selected">.get_selected ( context )</h3> |
|
<p>Returns all selected nodes. If context is set - only the selected nodes within that context are returned.</p> |
|
<ul class="arguments"> |
|
<li> |
|
<code class="tp">mixed</code> <strong>context</strong> |
|
<p>This can be a DOM node, jQuery node or selector pointing to an element within the tree.</p> |
|
</li> |
|
</ul> |
|
|
|
<h3 id="is_selected">.is_selected ( node )</h3> |
|
<p>Returns whether the specified node is selected or not.</p> |
|
<ul class="arguments"> |
|
<li> |
|
<code class="tp">mixed</code> <strong>node</strong> |
|
<p>This can be a DOM node, jQuery node or selector pointing to an element within the tree.</p> |
|
</li> |
|
</ul> |
|
|
|
</div> |
|
|
|
</div> |
|
</body> |
|
</html>
|
|
|