jstree树形结构Api

男娘i 2022-04-16 02:10 299阅读 0赞

1. jsTree 核心功能（core functionality）

## 1.1. $.jstree ##

包含所有 jstree 相关的函数和变量，包括用于创建、访问、维护实例的类和方法。

## 1.2. $.jstree.version ##

jstree 的版本号

## 1.3. $.jstree.defaults ##

包含用于创建新实例的默认配置

## 1.4. $.jstree.defaults.plugins ##

默认是`[]`。

配置实例中使用的插件。是一个字符串数组，每个字符串是一个插件名。

## 1.5. $.jstree.plugins ##

存放所有已加载的插件（内部用）

## 1.6. $.jstree.create (el \[, options\]) ##

创建一个 jstree 实例

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>el</code></td> 
   <td><code>DOMElement</code>&nbsp;<code>jQuery</code>&nbsp;<code>String</code>，要创建实例的元素，可以是jQuery对象或一个选择器</td> 
  </tr> 
  <tr> 
   <td><code>options</code></td> 
   <td><code>Object</code>&nbsp;此实例的配置（扩展自<code>$.jstree.defaults</code>）</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>jsTree</code>&nbsp;新的实例</td> 
  </tr> 
 </tbody> 
</table>

## 1.7. $.jstree.destroy () ##

从 DOM 中删除 jstree 的所有痕迹，并销毁所有的实例。

## 1.8. $.jstree.core (id) - - private ##

jstree 类的构造函数，仅用于内部。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>id</code></td> 
   <td><code>Number</code>&nbsp;此实例的索引号（index）</td> 
  </tr> 
 </tbody> 
</table>

## 1.9. $.jstree.reference (needle) ##

获取一个已存在实例的引用。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>needle</code></td> 
   <td><code>DOMElement</code>&nbsp;<code>jQuery</code>&nbsp;<code>String</code></td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>jsTree</code>&nbsp;<code>null</code>&nbsp;实例，若找不到实例则返回&nbsp;<code>null</code></td> 
  </tr> 
 </tbody> 
</table>

**Examples**

// provided a container with an ID of "tree", and a nested node with an ID of "branch"
    // all of there will return the same instance
    $.jstree.reference('tree');
    $.jstree.reference('#tree');
    $.jstree.reference($('#tree'));
    $.jstree.reference(document.getElementByID('tree'));
    $.jstree.reference('branch');
    $.jstree.reference('#branch');
    $.jstree.reference($('#branch'));
    $.jstree.reference(document.getElementByID('branch'));

## 1.10. $().jstree(\[arg\]) ##

创建实例、获取实例、在实例中调用命令。

*  若当前节点（node）没有关联的实例，则会新建一个实例。新建实例时，将`arg`用于扩展`$.jstree.defaults`。 此时将没有返回值（不会中断链式操作）。
    
    \+
 *  若已存在实例，且`arg`是一个字符串，则此实例将执行`arg`中填的命令及命令参数。 若此命令有返回值，则返回此值（此命令函数可能会影响链式操作）。
    
    \+
 *  若已存在实例，且`arg`不是一个字符串，则返回此实例（类似`$.jstree.reference`）。
    
    \+
 *  其他情况，则无返回值，且不会中断链式操作。
    
    \+

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>arg</code></td> 
   <td><code>String</code>&nbsp;<code>Object</code></td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Mixed</code></td> 
  </tr> 
 </tbody> 
</table>

**Examples**

$('#tree1').jstree(); // creates an instance
    $('#tree2').jstree({ plugins : [] }); // create an instance with some options
    $('#tree1').jstree('open_node', '#branch_1'); // call a method on an existing instance, passing additional arguments
    $('#tree2').jstree(); // get an existing instance (or create an instance)
    $('#tree2').jstree(true); // get an existing instance (will not create new instance)
    $('#branch_1').jstree().select_node('#branch_1'); // get an instance (using a nested element and call a method)

## 1.11. $(':jstree') ##

用于在实例中查找元素。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>jQuery</code></td> 
  </tr> 
 </tbody> 
</table>

**Examples**

$('div:jstree').each(function () {
        $(this).jstree('destroy');
    });

## 1.12. $.jstree.defaults.core ##

存储核心功能的所有默认配置。

## 1.13. $.jstree.defaults.core.data ##

数据配置。

若值为`false`，则 jstree 容器元素内的 HTML 将用于构建树（这些元素应是一些包含子项的无序列表）。

你也可以在这里传入一个 HTML 字符串 或 JSON 数字。

还可以传入一个 jQuery 的 AJAX 配置，jstree 会自动判断响应的类型（JSON 或 HTML）来构建树。

除了标准的 jQuery AJAX 选项，这里还可传入函数给`data`和`url`。 这些函数将接收一个参数（加载的节点），返回的值作为最终的配置。

最后，还可传入一个函数。此函数将接收 2 个参数：1 个是加载的节点，1 个是回调函数。 函数最后应执行回调函数。

**Examples**

// AJAX
    $('#tree').jstree({
        'core' : {
            'data' : {
                'url' : '/get/children/',
                'data' : function (node) {
                    return { 'id' : node.id };
                }
            }
        });
    
    // direct data
    $('#tree').jstree({
        'core' : {
            'data' : [
                'Simple root node',
                {
                    'id' : 'node_2',
                    'text' : 'Root node with options',
                    'state' : { 'opened' : true, 'selected' : true },
                    'children' : [ { 'text' : 'Child 1' }, 'Child 2']
                }
            ]
        }
    });
    
    // function
    $('#tree').jstree({
        'core' : {
            'data' : function (obj, callback) {
                callback.call(this, ['Root 1', 'Root 2']);
            }
        });

## 1.14. $.jstree.defaults.core.strings ##

配置在树整个过程中出现的文字。

*  可以是一个对象，对象中的 key、value 对应你要替换的内容。
    
    \+
 *  可以是一个函数，此函数将接收一个参数（将用到的字符串），并应返回一个替代的字符串。
    
    \+

**Examples**

// function
    $('#tree').jstree({
        'core' : {
            'data' : function (obj, callback) {
                callback.call(this, ['Root 1', 'Root 2']);
            }
        });

## 1.15. $.jstree.defaults.core.check\_callback ##

当用户想修改树的结构时，此参数用于决定是否允许修改 或 如何修改。

*  `false`，所有操作（创建 create、重命名 rename、删除 delete、移动 move、复制 copy）都将被阻止。
 *  `true`，所有操作都被允许。
 *  函数，更详细的逻辑控制。

**Examples**

$('#tree').jstree({
        'core' : {
            'check_callback' : function (operation, node, node_parent, node_position, more) {
                // operation can be 'create_node', 'rename_node', 'delete_node', 'move_node' or 'copy_node'
                // in case of 'rename_node' node_position is filled with the new node name
                return operation === 'rename_node' ? true : false;
            }
        }
    });

## 1.16. $.jstree.defaults.core.error ##

出错时（树操作被阻止、AJAX 失败等）的回调函数。 此回调函数将接收一个参数。

## 1.17. $.jstree.defaults.core.animation ##

打开、折叠时的动画过渡时间。

*  默认：200
 *  `false`：禁用动画过渡
 *  数字：单位 毫秒

## 1.18. $.jstree.defaults.core.multiple ##

是否允许节点多选。

## 1.19. $.jstree.defaults.core.themes ##

一个对象，用于配置主题。

## 1.20. $.jstree.defaults.core.themes.name ##

主题的名字（若为`false`，则使用默认主题）

## 1.21. $.jstree.defaults.core.themes.url ##

主题对应的 CSS 文件的 URL。

*  字符串：URL
 *  `false`：不加载额外的 CSS 文件（因为你可在页面手动包含主题的 CSS 文件）
 *  `true`：jstree 将尝试自动加载主题 CSS 文件

## 1.22. $.jstree.defaults.core.themes.dir ##

所有主题的目录。

只有当`url`的值为`true`时才生效。

## 1.23. $.jstree.defaults.core.themes.dots ##

boolean，是否显示树连接线。

## 1.24. $.jstree.defaults.core.themes.icons ##

boolean，是否显示节点的图标。

## 1.25. $.jstree.defaults.core.themes.ellipsis ##

boolean，节点名过长时是否显示省略号。

仅当容器是固定宽度时（fixed width）才生效。

## 1.26. $.jstree.defaults.core.themes.stripes ##

背景是否显示间纹。

## 1.27. $.jstree.defaults.core.themes.variant ##

字符串（或`false`），指定主题的形态变化（前提是主题支持形态变化，如大小）。

## 1.28. $.jstree.defaults.core.themes.responsive ##

boolean（默认`false`），是否使用主题的响应式状态（遇到小屏设备时）。

## 1.29. $.jstree.defaults.core.expand\_selected\_onload ##

boolean，决定是否在加载树时打开所有选中的节点。

## 1.30. $.jstree.defaults.core.worker ##

默认`true`。

当为`true`时，将尽可能使用 web worker（译注：理解为多线程） 来解释接收到的 JSON 数据， 这样的好处是有较大的请求时，不容易使 UI 变卡顿。

注意的是，使用 web worker 时，将慢约 30%。

## 1.31. $.jstree.defaults.core.force\_text ##

boolean（默认`false`），强制将节点的 text 值解释为纯文本。

## 1.32. $.jstree.defaults.core.dblclick\_toggle ##

boolean（默认`true`），双击节点名时是否选择（toggled）节点。

## 1.33. plugin (deco \[, opts\]) - - private ##

用于为实例设置插件，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>deco</code></td> 
   <td><code>String</code>&nbsp;插件名</td> 
  </tr> 
  <tr> 
   <td><code>opts</code></td> 
   <td><code>Object</code>&nbsp;插件的配置</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>jsTree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.34. init (el, optons) - - private ##

初始化实例，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>el</code></td> 
   <td><code>DOMElement</code>&nbsp;<code>jQuery</code>&nbsp;<code>String</code>&nbsp;将要成为树元素</td> 
  </tr> 
  <tr> 
   <td><code>options</code></td> 
   <td><code>Object</code>&nbsp;实例的配置</td> 
  </tr> 
  <tr> 
   <td><code>触发器（Triggers）</code></td> 
   <td><code>init.jstree</code>&nbsp;<code>loading.jstree</code>&nbsp;<code>loaded.jstree</code>&nbsp;<code>ready.jstree</code>&nbsp;<code>changed.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.35. init.jstree （ Event ⚡ ） ##

当所有事件都已绑定后触发。

## 1.36. loading.jstree （ Event ⚡ ） ##

在加载文本（loading text）已显示，且在加载（loading）开始之前，触发。

## 1.37. destroy () ##

销毁一个实例。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>keep_html</code></td> 
   <td><code>Boolean</code>&nbsp;若为<code>true</code>，树容器将被清空，否则将保持原状</td> 
  </tr> 
 </tbody> 
</table>

## 1.38. 创建节点原型（Create prototype node） ##

## 1.39. teardown () - - private ##

销毁实例的其中一步，仅内部使用。

## 1.40. bind () - - private ##

绑定所有事件，仅内部使用。

## 1.41. loaded.jstree （ Event ⚡ ） ##

当根节点（root）第一次加载时触发。

## 1.42. ready.jstree （ Event ⚡ ） ##

当所有节点都加载完毕时触发。

## 1.43. unbind () - - private ##

销毁实例的其中一步，仅内部使用。

## 1.44. trigger (ev \[, data\]) - - private ##

触发一个事件，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>ev</code></td> 
   <td><code>String</code>&nbsp;要触发的事件名称</td> 
  </tr> 
  <tr> 
   <td><code>data</code></td> 
   <td><code>Object</code>&nbsp;传递给事件的附加数据</td> 
  </tr> 
 </tbody> 
</table>

## 1.45. get\_container () ##

返回扩展自 jQuery 的实例容器

<table> 
 <thead> 
  <tr> 
   <th>返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>jQuery</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.46. get\_container\_ul () - - private ##

返回扩展自 jQuery 的主 UL 元素节点（树实例容器中），仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>jQuery</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.47. get\_string (key) - - private ##

获取树中用到的字符串（本地化），仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>key</code></td> 
   <td><code>String</code></td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>String</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.48. \_firstChild (dom) - - private ##

获取 DOM 节点中的第一个子元素，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>dom</code></td> 
   <td><code>DOMElement</code></td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>DOMElement</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.49. \_nextSibling (dom) - - private ##

获取 DOM 节点的下一个兄弟节点，仅内部使用。

## 1.50. \_previousSibling (dom) - - private ##

获取 DOM 节点的上一个兄弟节点，仅内部使用。

## 1.51. get\_node (obj \[, as\_dom\]) ##

根据输入（子 DOM 元素、ID字符串、选择器等）获取节点的 JSON 形式数据（或 扩展自 jQuery 的 DOM 节点）。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code></td> 
  </tr> 
  <tr> 
   <td><code>as_dom</code></td> 
   <td><code>Boolean</code></td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Object</code>&nbsp;<code>jQuery</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.52. get\_path (obj \[, glue, ids\]) ##

获取节点的路径。可能是

*  一堆节点名称
 *  一堆节点ID
 *  一堆节点名和 ID（或数组）

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;节点</td> 
  </tr> 
  <tr> 
   <td><code>glue</code></td> 
   <td><code>String</code>&nbsp;若是字符串，则填间隔字符串（如<code>/</code>），若是一个假值（<a href="https://developer.mozilla.org/en-US/docs/Glossary/Falsy" rel="nofollow">译注</a>），则返回数组</td> 
  </tr> 
  <tr> 
   <td><code>ids</code></td> 
   <td><code>Boolean</code>&nbsp;若为<code>true</code>则用节点ID 构建路径，否则用节点名称</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>mixed</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.53. get\_next\_dom (obj \[, strict\]) ##

获取`obj`节点的下一个可见节点，若`strict`为`true`，则只可能返回兄弟节点。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code></td> 
  </tr> 
  <tr> 
   <td><code>strict</code></td> 
   <td><code>Boolean</code></td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>jQuery</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.54. get\_prev\_dom (obj \[, strict\]) ##

获取`obj`节点的前一个可见节点，若`strict`为`true`，则只可能返回兄弟节点。

## 1.55. get\_parent (obj) ##

获取节点的父节点。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code></td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>String</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.56. get\_children\_dom (obj) ##

获取节点的所有子节点（jQuery 集合）（节点必须是已渲染的）。

## 1.57. is\_parent (obj) ##

判断一个节点是否包含子节点。

## 1.58. is\_loaded (obj) ##

判断一个节点是否已加载（其子节点已可用）。

## 1.59. is\_loading (obj) ##

判断一个节点是否正在加载（正在拉取子节点）。

## 1.60. is\_open (obj) ##

判断一个节点是否已打开。

## 1.61. is\_closed (obj) ##

判断一个节点是否关闭状态。

## 1.62. is\_leaf (obj) ##

判断一个节点是不是没包含子节点。

## 1.63. load\_node (obj \[, callback\]) ##

加载一个节点（即使用 `core.data` 的设置来拉取子节点），支持传入多个节点（数组形式）。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code></td> 
  </tr> 
  <tr> 
   <td><code>callback</code></td> 
   <td><code>function</code>&nbsp;加载完毕的回调，将在实例的范围中执行，并接收两个参数：节点、boolean 状态</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Boolean</code></td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>load_node.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.64. load\_node.jstree （ Event ⚡ ） ##

一个节点加载完毕后触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>Object</code>&nbsp;已加载的节点</td> 
  </tr> 
  <tr> 
   <td><code>status</code></td> 
   <td><code>Boolean</code>&nbsp;是否加载成功</td> 
  </tr> 
 </tbody> 
</table>

## 1.65. \_load\_nodes (nodes \[, callback\]) - - private ##

加载多个节点（数组）（只有出现在结构中，也会加载不可用的节点），仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>array</code></td> 
  </tr> 
  <tr> 
   <td><code>callback</code></td> 
   <td><code>function</code>&nbsp;加载完毕的回调，将在实例的范围中执行，并接收 1 个参数：传入的那些节点（数组）</td> 
  </tr> 
 </tbody> 
</table>

## 1.66. load\_all (\[obj, callback\]) ##

加载所有仍未加载的节点。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>mixed</code>&nbsp;加载节点下的所有节点，而非整棵树的所有节点</td> 
  </tr> 
  <tr> 
   <td><code>status</code></td> 
   <td><code>function</code>&nbsp;加载成功的回调</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>load_all.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.67. load\_all.jstree （ Event ⚡ ） ##

`load_all`执行完毕后触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>Object</code>&nbsp;已递归加载的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.68. \_load\_node (obj \[, callback\]) - - private ##

真正处理一个节点的加载过程，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code></td> 
  </tr> 
  <tr> 
   <td><code>callback</code></td> 
   <td><code>function</code>&nbsp;加载完毕后执行此回调函数，此函数允许在实例范围内，并将接收 1 个状态参数（boolean）</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Boolean</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.69. \_node\_changed (obj \[, callback\]) - - private ##

添加一个节点到将要重绘的节点列表中，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.70. \_append\_html\_data (obj, data) - - private ##

添加 HTML 内容到树，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;要添加到的节点</td> 
  </tr> 
  <tr> 
   <td><code>data</code></td> 
   <td><code>String</code>&nbsp;HTML 字符串</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>model.jstree</code>&nbsp;<code>changed.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.71. model.jstree （ Event ⚡ ） ##

当新数据插入到树模型（tree model）中时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>nodes</code></td> 
   <td><code>Array</code>&nbsp;节点ID 数组</td> 
  </tr> 
  <tr> 
   <td><code>parent</code></td> 
   <td><code>String</code>&nbsp;这些节点的父节点ID</td> 
  </tr> 
 </tbody> 
</table>

## 1.72. \_append\_json\_data (obj, data) - - private ##

添加 JSON 内容到树，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;要添加到的节点</td> 
  </tr> 
  <tr> 
   <td><code>data</code></td> 
   <td><code>String</code>&nbsp;JSON 对象字符串</td> 
  </tr> 
  <tr> 
   <td><code>force_processing</code></td> 
   <td><code>Boolean</code>&nbsp;内部参数（无需设置）</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>model.jstree</code>&nbsp;<code>changed.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.73. \_parse\_model\_from\_html (d \[, p, ps\]) - - private ##

从jQuery对象中解释节点，并添加到树的内存模型中，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>d</code></td> 
   <td><code>jQuery</code>jQuery对象</td> 
  </tr> 
  <tr> 
   <td><code>p</code></td> 
   <td><code>String</code>&nbsp;父节点ID</td> 
  </tr> 
  <tr> 
   <td><code>ps</code></td> 
   <td><code>Array</code>&nbsp;所有的父节点列表</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>String</code>&nbsp;将被添加到模型中的节点ID</td> 
  </tr> 
 </tbody> 
</table>

## 1.74. \_parse\_model\_from\_flat\_json (d \[, p, ps\]) - - private ##

从 JSON 对象中解释节点（用于处理扁平数据，即无嵌套的子节点，但这些子节点拥有 ID 和 父节点ID）， 并添加到树的内存模型中，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>d</code></td> 
   <td><code>Object</code>&nbsp;JSON 对象</td> 
  </tr> 
  <tr> 
   <td><code>p</code></td> 
   <td><code>String</code>&nbsp;父节点ID</td> 
  </tr> 
  <tr> 
   <td><code>ps</code></td> 
   <td><code>Array</code>&nbsp;所有的父节点列表</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>String</code>&nbsp;将被添加到模型中的节点ID</td> 
  </tr> 
 </tbody> 
</table>

## 1.75. \_parse\_model\_from\_json (d \[, p, ps\]) - - private ##

从 JSON 对象中解释节点，并添加到树的内存模型中，仅内部使用。

## 1.76. \_redraw () - - private ##

重绘所有需要重绘的节点，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>redraw.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.77. redraw.jstree （ Event ⚡ ） ##

当节点们重绘完毕后触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>nodes</code></td> 
   <td><code>array</code>&nbsp;已重绘的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.78. redraw (\[full\]) ##

重绘所有需要重绘的节点，或者 重绘整个树的所有节点。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>full</code></td> 
   <td><code>Boolean</code>&nbsp;若<code>true</code>则重绘整个树的所有节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.79. draw\_children (node) - - private ##

重绘单个节点的子节点，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>mixed</code>&nbsp;节点（将重绘其子节点）</td> 
  </tr> 
 </tbody> 
</table>

## 1.80. redraw\_node (node, deep, is\_callback, force\_render) - - private ##

重绘单个节点，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>mixed</code>&nbsp;将要重绘的节点</td> 
  </tr> 
  <tr> 
   <td><code>deep</code></td> 
   <td><code>Boolean</code>&nbsp;是否也重绘子节点</td> 
  </tr> 
  <tr> 
   <td><code>is_callback</code></td> 
   <td><code>Boolean</code>&nbsp;是否递归调用</td> 
  </tr> 
  <tr> 
   <td><code>force_render</code></td> 
   <td><code>Boolean</code>&nbsp;是否也重绘父节点未打开的子节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.81. open\_node (obj \[, callback, animation\]) ##

打开一个节点，看到其子节点（原文：revaling its children）。 若此节点还未被加载，将先加载此节点，再打开。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;将要打开的节点</td> 
  </tr> 
  <tr> 
   <td><code>callback</code></td> 
   <td><code>Function</code>&nbsp;节点打开完毕后的回调</td> 
  </tr> 
  <tr> 
   <td><code>animation</code></td> 
   <td><code>Number</code>&nbsp;打开节点时的动画过渡时间（毫秒）（覆盖<code>core.animation</code>的设置），若为<code>false</code>则禁用动画效果</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>open_node.jstree</code>&nbsp;<code>after_open.jstree</code>&nbsp;<code>before_open.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.82. before\_open.jstree （ Event ⚡ ） ##

当一个节点即将被打开时触发（if the node is supposed to be in the DOM, it will be, but it won't be visible yet）。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>Object</code>&nbsp;将打开的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.83. open\_node.jstree （ Event ⚡ ） ##

当一个节点打开完毕时触发（若有过渡动画，此时动画应该还没完毕）。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>Object</code>&nbsp;打开完毕的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.84. after\_open.jstree （ Event ⚡ ） ##

当一个节点打开完毕，且过渡动画也已完毕时触发。

## 1.85. \_open\_to (obj) - - private ##

打开节点的所有父节点（此时节点应已加载）

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;需显示的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.86. close\_node (obj \[, animation\]) ##

关闭一个节点，并隐藏其子节点

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;需关闭的节点</td> 
  </tr> 
  <tr> 
   <td><code>animation</code></td> 
   <td><code>Number</code>&nbsp;关闭节点时的动画过渡时间（毫秒）（覆盖<code>core.animation</code>的设置），若为<code>false</code>则禁用动画效果</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>close_node.jstree</code>&nbsp;<code>after_close.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.87. close\_node.jstree （ Event ⚡ ） ##

当一个节点关闭完毕时触发（若有过渡动画，此时动画应该还没完毕）。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>Object</code>&nbsp;关闭完毕的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.88. after\_close.jstree （ Event ⚡ ） ##

当一个节点关闭完毕，且过渡动画也已完毕时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;关闭完毕的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.89. toggle\_node (obj) ##

切换节点的状态，若已打开则关闭节点，若已关闭则打开节点。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;需切换状态的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.90. open\_all (\[obj, animation, original\_obj\]) ##

打开一个节点或整棵树的内所有节点，显示其子节点。 若节点还没加载，则先加载节点，完毕再打开节点。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;需递归打开的节点，若忽略则打开整棵树的所有节点</td> 
  </tr> 
  <tr> 
   <td><code>animation</code></td> 
   <td><code>Number</code>&nbsp;打开节点时动画的过渡时间（毫秒），默认禁用动画效果</td> 
  </tr> 
  <tr> 
   <td><code>reference</code></td> 
   <td><code>jQuery</code>&nbsp;开始处理的节点（内部使用）</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>open_all.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.91. open\_all.jstree （ Event ⚡ ） ##

当`open_all`完毕时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>Object</code>&nbsp;已打开的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.92. close\_all (\[obj, animation\]) ##

关闭一个节点或整棵树的所有节点（后面这句没懂：revaling their children）。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;需递归关闭的节点，若忽略则关闭整棵树的所有节点</td> 
  </tr> 
  <tr> 
   <td><code>animation</code></td> 
   <td><code>Number</code>&nbsp;打开节点时动画的过渡时间（毫秒），默认禁用动画效果</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>close_all.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.93. close\_all.jstree （ Event ⚡ ） ##

当`close_all`完毕时触发。

## 1.94. is\_disabled (obj) ##

检查一个节点是否被禁用了（即不可被选中）。

## 1.95. enable\_node (obj) ##

启用一个节点（这样节点才可被选中）。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;需启用的节点</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>enable_node.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.96. enable\_node.jstree （ Event ⚡ ） ##

当一个节点被启用时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>Object</code>&nbsp;需启用的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.97. disable\_node (obj) ##

禁用一个节点（这样节点不可被选中）。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;需禁用的节点</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>disable_node.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.98. disable\_node.jstree （ Event ⚡ ） ##

当一个节点被禁用时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>Object</code>&nbsp;需禁用的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.99. is\_hidden (obj) ##

检查一个节点是否被隐藏了。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;节点</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Boolean</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.100. hide\_node (obj) ##

隐藏一个节点（仍在树结构中，只是看不见了）。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;需隐藏的节点</td> 
  </tr> 
  <tr> 
   <td><code>skip_redraw</code></td> 
   <td><code>Boolean</code>&nbsp;是否需要重绘，内部参数</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>hide_node.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.101. hide\_node.jstree （ Event ⚡ ） ##

当一个节点被隐藏时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>Object</code>&nbsp;被隐藏的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.102. show\_node (obj) ##

显示一个节点。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;需显示的节点</td> 
  </tr> 
  <tr> 
   <td><code>skip_redraw</code></td> 
   <td><code>Boolean</code>&nbsp;是否需要重绘，内部参数</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>show_node.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.103. show\_node.jstree （ Event ⚡ ） ##

当一个节点被显示时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>Object</code>&nbsp;显示的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.104. hide\_all () ##

隐藏所有节点。

<table> 
 <thead> 
  <tr> 
   <th>触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>hide_node.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.105. hide\_all.jstree （ Event ⚡ ） ##

当所有节点被隐藏时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>nodes</code></td> 
   <td><code>Array</code>&nbsp;所有被隐藏节点的 ID 集合</td> 
  </tr> 
 </tbody> 
</table>

## 1.106. show\_all () ##

显示所有节点。

<table> 
 <thead> 
  <tr> 
   <th>触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>show_all.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.107. show\_all.jstree （ Event ⚡ ） ##

当所有节点被显示时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>nodes</code></td> 
   <td><code>Array</code>&nbsp;所有被显示节点的 ID 集合</td> 
  </tr> 
 </tbody> 
</table>

## 1.108. activate\_node (obj, e) - - private ##

当用户选中一个节点时被调用，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;节点</td> 
  </tr> 
  <tr> 
   <td><code>e</code></td> 
   <td><code>Object</code>&nbsp;相关的事件</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>activate_node.jstree</code>&nbsp;<code>changed.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.109. activate\_node.jstree （ Event ⚡ ） ##

当一个节点被用户点击或交互时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>nodes</code></td> 
   <td><code>Object</code></td> 
  </tr> 
  <tr> 
   <td><code>event</code></td> 
   <td><code>Object</code>&nbsp;触发调用的原始事件（也可能是一个空对象）</td> 
  </tr> 
 </tbody> 
</table>

## 1.110. hover\_node (obj) - - private ##

当用户鼠标移过节点时，使节点的状态变为`鼠标经过`状态，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code></td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>hover_node.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.111. hover\_node.jstree （ Event ⚡ ） ##

当用户鼠标经过节点时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>nodes</code></td> 
   <td><code>Object</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.112. dehover\_node (obj) - - private ##

当用户鼠标离开节点时，使移除节点的`鼠标经过`状态，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code></td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>dehover_node.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.113. dehover\_node.jstree （ Event ⚡ ） ##

当用户鼠标离开节点时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>nodes</code></td> 
   <td><code>Object</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.114. select\_node (obj \[, supress\_event, prevent\_open\]) ##

选择一个节点。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;需选中的节点数组</td> 
  </tr> 
  <tr> 
   <td><code>supress_event</code></td> 
   <td><code>Boolean</code>&nbsp;若为<code>true</code>，将不触发<code>changed.jstree</code>事件</td> 
  </tr> 
  <tr> 
   <td><code>prevent_open</code></td> 
   <td><code>Boolean</code>&nbsp;若为<code>true</code>，将不打开选中节点的父节点</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>select_node.jstree</code>&nbsp;<code>changed.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.115. select\_node.jstree （ Event ⚡ ） ##

当节点被选中时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>nodes</code></td> 
   <td><code>Object</code></td> 
  </tr> 
  <tr> 
   <td><code>selected</code></td> 
   <td><code>Array</code>&nbsp;已选中的节点</td> 
  </tr> 
  <tr> 
   <td><code>event</code></td> 
   <td><code>Object</code>&nbsp;触发本事件<code>select_node</code>的事件</td> 
  </tr> 
 </tbody> 
</table>

## 1.116. changed.jstree （ Event ⚡ ） ##

当已选中的节点发生变化（`选择`发生变化）时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>nodes</code></td> 
   <td><code>Object</code></td> 
  </tr> 
  <tr> 
   <td><code>action</code></td> 
   <td><code>Object</code>&nbsp;引起<code>选择</code>发生变化的<code>action</code></td> 
  </tr> 
  <tr> 
   <td><code>selected</code></td> 
   <td><code>Array</code>&nbsp;当前的已选中的节点</td> 
  </tr> 
  <tr> 
   <td><code>event</code></td> 
   <td><code>Object</code>&nbsp;触发本事件<code>changed_node</code>的事件</td> 
  </tr> 
 </tbody> 
</table>

## 1.117. deselect\_node (obj \[, supress\_event\]) ##

不选中节点。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;若为一个数组，则是需被不选中的节点列表</td> 
  </tr> 
  <tr> 
   <td><code>supress_event</code></td> 
   <td><code>Boolean</code>&nbsp;若为<code>true</code>，将不触发<code>changed.jstree</code>事件</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>deselect_node.jstree</code>&nbsp;<code>changed.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.118. deselect\_node.jstree （ Event ⚡ ） ##

当节点被从`选中`变为`不选中`状态时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>nodes</code></td> 
   <td><code>Object</code></td> 
  </tr> 
  <tr> 
   <td><code>selected</code></td> 
   <td><code>Array</code>&nbsp;当前的已选中的节点</td> 
  </tr> 
  <tr> 
   <td><code>event</code></td> 
   <td><code>Object</code>&nbsp;触发本事件<code>deselect_node</code>的事件</td> 
  </tr> 
 </tbody> 
</table>

## 1.119. select\_all (\[supress\_event\]) ##

选中树的所有节点。

## 1.120. select\_all.jstree （ Event ⚡ ） ##

当树中所有节点都被选中时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>selected</code></td> 
   <td><code>Array</code>&nbsp;当前的已选中的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.121. deselect\_all (\[supress\_event\]) ##

不选中树中所有节点。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>supress_event</code></td> 
   <td><code>Boolean</code>&nbsp;若为<code>true</code>，将不触发<code>changed.jstree</code>事件</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>deselect_all.jstree</code>&nbsp;<code>changed.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.122. deselect\_all.jstree （ Event ⚡ ） ##

当树中所有节点状态变为不选中时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>nodes</code></td> 
   <td><code>Object</code>&nbsp;之前的选中节点</td> 
  </tr> 
  <tr> 
   <td><code>selected</code></td> 
   <td><code>Array</code>&nbsp;当前的已选中的节点</td> 
  </tr> 
 </tbody> 
</table>

## 1.123. is\_selected (obj) ##

检查一个节点是否已被选中。

## 1.124. get\_selected (\[full\]) ##

获取所有已选中的节点。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>full</code></td> 
   <td><code>mixed</code>&nbsp;若为<code>true</code>则返回节点对象全部数据，否则只返回节点 ID 列表</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Array</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.125. get\_top\_selected (\[full\]) ##

获取顶层的被选中节点。

## 1.126. get\_bottom\_selected (\[full\]) ##

获取底层的被选中节点。

## 1.127. get\_state () - - private ##

获取树目前的状态（之后可使用`set_state(state)`来恢复状态），仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Object</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.128. set\_state (state \[, callback\]) - - private ##

设置树的状态，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>state</code></td> 
   <td><code>Object</code>&nbsp;要设置的状态。此对象是传引用，且 jstree 不会修改此对象</td> 
  </tr> 
  <tr> 
   <td><code>callback</code></td> 
   <td><code>Function</code>&nbsp;可选，设置状态完毕后的回调函数</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>set_state.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.129. set\_state.jstree （ Event ⚡ ） ##

当`set_state`完毕时触发。

## 1.130. refresh () ##

刷新树，所有的节点都将重新加载，并触发`load_node`。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>skip_loading</code></td> 
   <td><code>Boolean</code>&nbsp;是否跳过加载动画</td> 
  </tr> 
  <tr> 
   <td><code>forget_state</code></td> 
   <td><code>Mixed</code>&nbsp;若为<code>true</code>则将不可恢复原来的状态，若为一个函数（此函数将接收一个状态参数）则此函数的结果将作为状态</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>refresh.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.131. refresh.jstree （ Event ⚡ ） ##

当`refresh`完毕时触发。

## 1.132. refresh\_node (obj) ##

刷新一个节点（并重新加载其子节点，并触发`load_node`）。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>Mixed</code>&nbsp;节点</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>refresh_node.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.133. refresh\_node.jstree （ Event ⚡ ） ##

当节点刷新完毕时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>Object</code>&nbsp;已刷新的节点</td> 
  </tr> 
  <tr> 
   <td><code>nodes</code></td> 
   <td><code>Array</code>&nbsp;已重新加载的节点 ID 列表</td> 
  </tr> 
 </tbody> 
</table>

## 1.134. set\_id (obj, id) ##

设置节点 ID。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;节点</td> 
  </tr> 
  <tr> 
   <td><code>id</code></td> 
   <td><code>String</code>&nbsp;新 ID</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Boolean</code></td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>set_id.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.135. set\_id.jstree （ Event ⚡ ） ##

当节点的 ID 变化完毕时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>Object</code></td> 
  </tr> 
  <tr> 
   <td><code>old</code></td> 
   <td><code>String</code>&nbsp;旧 ID</td> 
  </tr> 
 </tbody> 
</table>

## 1.136. get\_text (obj) ##

获取节点名（text）

## 1.137. set\_text (obj, val) - - private ##

设置节点的名称。仅内部使用。请使用`rename_node(obj, val)`

<table> 
 <thead> 
  <tr> 
   <th>参数/返回/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;单个节点，或，多个节点组成的数组</td> 
  </tr> 
  <tr> 
   <td><code>val</code></td> 
   <td><code>String</code>&nbsp;新名称</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Boolean</code></td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>set_text.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.138. set\_text.jstree （ Event ⚡ ） ##

当节点的名称变化完毕时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>Object</code></td> 
  </tr> 
  <tr> 
   <td><code>text</code></td> 
   <td><code>String</code>&nbsp;新名称</td> 
  </tr> 
 </tbody> 
</table>

## 1.139. get\_json (\[obj, options\]) ##

获取一个节点（或整棵树）的 JSON 形式数据。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code></td> 
  </tr> 
  <tr> 
   <td><code>options</code></td> 
   <td><code>Object</code></td> 
  </tr> 
  <tr> 
   <td><code>options.no_state</code></td> 
   <td><code>Boolean</code>&nbsp;不包含状态</td> 
  </tr> 
  <tr> 
   <td><code>options.no_id</code></td> 
   <td><code>Boolean</code>&nbsp;不包含 ID</td> 
  </tr> 
  <tr> 
   <td><code>options.no_children</code></td> 
   <td><code>Boolean</code>&nbsp;不包含子节点</td> 
  </tr> 
  <tr> 
   <td><code>options.no_data</code></td> 
   <td><code>Boolean</code>&nbsp;不包含节点数据（node data）</td> 
  </tr> 
  <tr> 
   <td><code>options.no_li_attr</code></td> 
   <td><code>Boolean</code>&nbsp;不包含<code>LI</code>元素的属性<code>attributes</code></td> 
  </tr> 
  <tr> 
   <td><code>options.no_a_attr</code></td> 
   <td><code>Boolean</code>&nbsp;不包含<code>A</code>元素的属性<code>attributes</code></td> 
  </tr> 
  <tr> 
   <td><code>options.flat</code></td> 
   <td><code>Boolean</code>&nbsp;返回扁平 JSON 数据，而不是嵌套数据</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Object</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.140. create\_node (\[par, node, pos, callback, is\_loaded\]) ##

创建一个新节点（不要和`load_node`搞混）。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>par</code></td> 
   <td><code>mixed</code>&nbsp;父节点（若是创建根节点请用<code>#</code>或<code>null</code>）</td> 
  </tr> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>mixed</code>&nbsp;新节点的数据（JSON 对象，或节点名字符串）</td> 
  </tr> 
  <tr> 
   <td><code>pos</code></td> 
   <td><code>mixed</code>&nbsp;插入节点的位置（index），支持<code>first</code>和<code>last</code>，默认是<code>last</code></td> 
  </tr> 
  <tr> 
   <td><code>callback</code></td> 
   <td><code>Function</code>&nbsp;节点创建完毕后的毁回调函数</td> 
  </tr> 
  <tr> 
   <td><code>is_loaded</code></td> 
   <td><code>Boolean</code>&nbsp;内部参数，用于检测父节点是否已成功加载</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>String</code>&nbsp;新建节点的 ID</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>model.jstree</code>&nbsp;<code>create_node.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.141. create\_node.jstree （ Event ⚡ ） ##

当节点创建完毕时触发。

## 1.142. rename\_node (obj, val) ##

重命名节点。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;节点，也可是一个数组，里面的节点将重命名为相同的名字</td> 
  </tr> 
  <tr> 
   <td><code>val</code></td> 
   <td><code>String</code>&nbsp;新名称</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Boolean</code></td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>rename_node.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.143. rename\_node.jstree （ Event ⚡ ） ##

当节点重命名完毕时触发。

## 1.144. delete\_node (obj) ##

删除节点。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;节点，也可是一个数组，将同时删除多个</td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Boolean</code></td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>delete_node.jstree</code>&nbsp;<code>changed.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.145. delete\_node.jstree （ Event ⚡ ） ##

当节点删除完毕时触发。

## 1.146. check (chk, obj, par, pos) - - private ##

检查此树是否允许某种操作，仅内部使用。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>chk</code></td> 
   <td><code>String</code>&nbsp;操作名，可以是<code>create_node</code>&nbsp;<code>rename_node</code>&nbsp;<code>delete_node</code>&nbsp;<code>copy_node</code>&nbsp;<code>move_node</code></td> 
  </tr> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;节点</td> 
  </tr> 
  <tr> 
   <td><code>par</code></td> 
   <td><code>mixed</code>&nbsp;父节点</td> 
  </tr> 
  <tr> 
   <td><code>pos</code></td> 
   <td><code>mixed</code>&nbsp;插入的位置，或<code>rename_node</code>时的新名称</td> 
  </tr> 
  <tr> 
   <td><code>more</code></td> 
   <td><code>mixed</code>&nbsp;各种附加信息，如 DND 插件触发&nbsp;<code>move_node</code>&nbsp;操作时，此值就是<code>鼠标经过的节点</code></td> 
  </tr> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Boolean</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.147. last\_error () ##

获取最后的错误信息。

<table> 
 <thead> 
  <tr> 
   <th>返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Object</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.148. move\_node (obj, par \[, pos, callback, is\_loaded\]) ##

移动节点到新的父节点。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;需移动的节点（也可以是一个节点数组）</td> 
  </tr> 
  <tr> 
   <td><code>par</code></td> 
   <td><code>mixed</code>&nbsp;新的父节点</td> 
  </tr> 
  <tr> 
   <td><code>pos</code></td> 
   <td><code>mixed</code>&nbsp;插入节点的位置（除了整数值，还支持<code>first</code>&nbsp;<code>last</code>&nbsp;<code>before</code>&nbsp;<code>after</code>）默认是整数<code>0</code></td> 
  </tr> 
  <tr> 
   <td><code>callback</code></td> 
   <td><code>Function</code>&nbsp;节点移动完毕后的毁回调函数，接收 3 个参数：节点、新父节点、位置</td> 
  </tr> 
  <tr> 
   <td><code>is_loaded</code></td> 
   <td><code>Boolean</code>&nbsp;内部参数，用于检测父节点是否已成功加载</td> 
  </tr> 
  <tr> 
   <td><code>skip_redraw</code></td> 
   <td><code>mixed</code>&nbsp;内部参数，是否重画整棵树</td> 
  </tr> 
  <tr> 
   <td><code>instance</code></td> 
   <td><code>mixed</code>&nbsp;内部参数，检测节点是否来自另一个树实例</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>move_node.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.149. move\_node.jstree （ Event ⚡ ） ##

当节点移动完毕时触发。

## 1.150. copy\_node (obj, par \[, pos, callback, is\_loaded\]) ##

复制节点到新的父节点。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;需复制的节点（也可以是一个节点数组）</td> 
  </tr> 
  <tr> 
   <td><code>par</code></td> 
   <td><code>mixed</code>&nbsp;新的父节点</td> 
  </tr> 
  <tr> 
   <td><code>pos</code></td> 
   <td><code>mixed</code>&nbsp;插入节点的位置（除了整数值，还支持<code>first</code>&nbsp;<code>last</code>&nbsp;<code>before</code>&nbsp;<code>after</code>）默认是整数<code>0</code></td> 
  </tr> 
  <tr> 
   <td><code>callback</code></td> 
   <td><code>Function</code>&nbsp;节点复制完毕后的毁回调函数，接收 3 个参数：节点、新父节点、位置</td> 
  </tr> 
  <tr> 
   <td><code>is_loaded</code></td> 
   <td><code>Boolean</code>&nbsp;内部参数，用于检测父节点是否已成功加载</td> 
  </tr> 
  <tr> 
   <td><code>skip_redraw</code></td> 
   <td><code>mixed</code>&nbsp;内部参数，是否重画整棵树</td> 
  </tr> 
  <tr> 
   <td><code>instance</code></td> 
   <td><code>mixed</code>&nbsp;内部参数，检测节点是否来自另一个树实例</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>model.jstree</code>&nbsp;<code>copy_node.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.151. copy\_node.jstree （ Event ⚡ ） ##

当节点复制完毕时触发。

## 1.152. cut (obj) ##

剪切节点（之后需调用`paste(obj)`粘贴节点）。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;需剪切的节点（也可以是一个节点数组）</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>cut.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.153. cut.jstree （ Event ⚡ ） ##

当节点添加到缓存区待移动时触发。

| `node` | `Array` |

## 1.154. copy (obj) ##

复制节点（之后需调用`paste(obj)`粘贴节点）。

## 1.155. copy.jstree （ Event ⚡ ） ##

当节点添加到缓存区待复制时触发。

| 参数 | 描述 | | `node` | `Array` |

## 1.156. get\_buffer () ##

获取当前的缓存（缓存是一些待粘贴的节点）。

<table> 
 <thead> 
  <tr> 
   <th>返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Object</code>&nbsp;一个对象，包含：状态<code>mode</code>（<code>copy_node</code>或<code>move_node</code>）、节点<code>node</code>（节点数组）、实例<code>instance</code>（树实例）</td> 
  </tr> 
 </tbody> 
</table>

## 1.157. can\_paste () ##

检测缓存中是否有东西待粘贴。

<table> 
 <thead> 
  <tr> 
   <th>返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>Boolean</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.158. paste (obj \[, pos\]) ##

复制或移动之前剪切或复制的节点到新父节点中。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code>&nbsp;新父节点</td> 
  </tr> 
  <tr> 
   <td><code>pos</code></td> 
   <td><code>mixed</code>&nbsp;插入的位置（除了整数，也支持<code>first</code>&nbsp;<code>last</code>），默认值<code>0</code></td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>paste.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.159. paste.jstree （ Event ⚡ ） ##

当粘贴操作完毕时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>parent</code></td> 
   <td><code>String</code>&nbsp;接收粘贴节点的 ID</td> 
  </tr> 
  <tr> 
   <td><code>node</code></td> 
   <td><code>Array</code>&nbsp;缓存中的节点列表</td> 
  </tr> 
  <tr> 
   <td><code>mode</code></td> 
   <td><code>String</code>&nbsp;执行的操作，<code>copu_node</code>或<code>move_node</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.160. clear\_buffer () ##

清除缓存（因复制、剪切操作产生的）。

<table> 
 <thead> 
  <tr> 
   <th>触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>clear_buffer.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.161. clear\_buffer.jstree （ Event ⚡ ） ##

当复制或剪切的缓存被清空完毕时触发。

## 1.162. edit (obj \[, default\_text, callback\]) ##

使节点进入编辑模式（将出现一个`input`元素，用于重命名节点）。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code></td> 
  </tr> 
  <tr> 
   <td><code>default_text</code></td> 
   <td><code>String</code>&nbsp;默认名称（若不填，或填一个空字符串，则默认为节点目前的名称）</td> 
  </tr> 
  <tr> 
   <td><code>callback</code></td> 
   <td><code>Function</code>&nbsp;离开编辑框时将执行的回调函数，执行环境是实例内，将接收 3 个参数：节点、状态（<code>true</code>则重命名成功，否则失败）、Boolean值（用户是否可取消编辑）。可通过<code>.text</code>获取节点名</td> 
  </tr> 
 </tbody> 
</table>

## 1.163. set\_theme (theme\_name \[, theme\_url\]) ##

设置主题。

<table> 
 <thead> 
  <tr> 
   <th>参数/触发</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>theme_name</code></td> 
   <td><code>String</code>&nbsp;主题名</td> 
  </tr> 
  <tr> 
   <td><code>theme_url</code></td> 
   <td><code>mixed</code>&nbsp;主题的 CSS 文件的 URL，若不填或<code>false</code>，则你需手动加载该文件，若<code>true</code>则将尝试自动从<code>core.theme.dir</code>目录中加载</td> 
  </tr> 
  <tr> 
   <td><code>触发事件</code></td> 
   <td><code>set_theme.jstree</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.164. set\_theme.jstree （ Event ⚡ ） ##

当设置主题完毕时触发。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>theme</code></td> 
   <td><code>String</code>&nbsp;主题名</td> 
  </tr> 
 </tbody> 
</table>

## 1.165. get\_theme () ##

获取当前的主题名。

<table> 
 <thead> 
  <tr> 
   <th>返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>返回</code></td> 
   <td><code>String</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.166. set\_theme\_variant (variant\_name) ##

设置主题的变体`variant`（如果变体存在的话）。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>variant_name</code></td> 
   <td><code>String</code>&nbsp;<code>Boolean</code>&nbsp;主题的变体（若<code>false</code>，则移除当前的变体）</td> 
  </tr> 
 </tbody> 
</table>

## 1.167. show\_stripes () ##

在树容器背景中显示间隔条纹（前提是当前主题支持）

## 1.168. show\_stripes.jstree （ Event ⚡ ） ##

当间隔条纹显示完毕时触发。

## 1.169. hide\_stripes () ##

在树容器背景中显示间隔条纹。

## 1.170. hide\_stripes.jstree （ Event ⚡ ） ##

当间隔条纹隐藏完毕时触发。

## 1.171. toggle\_stripes () ##

消或隐树容器背景中的间隔条纹。

## 1.172. show\_dots () ##

在树容器中显示连接线（前提是主题支持）

## 1.173. show\_dots.jstree （ Event ⚡ ） ##

当连接线显示时触发。

## 1.174. hide\_dots () ##

在树容器中隐藏连接线。

## 1.175. hide\_dots.jstree （ Event ⚡ ） ##

当连接线隐藏时触发。

## 1.176. toggle\_dots () ##

消或隐树容器背景中的连接线。

## 1.177. show\_icons () ##

显示节点的图标。

## 1.178. show\_icons.jstree （ Event ⚡ ） ##

当节点图标显示时触发。

## 1.179. hide\_icons () ##

因此节点的图标。

## 1.180. hide\_icons.jstree （ Event ⚡ ） ##

当节点图标隐藏时触发。

## 1.181. toggle\_icons () ##

消或隐节点的图标。

## 1.182. show\_ellipsis () ##

当节点名过长时，显示过长的部分为`...`。

## 1.183. show\_ellipsis.jstree （ Event ⚡ ） ##

当节点名过长，显示过长的部分为`...`时触发。（原文：triggered when ellisis is shown）

## 1.184. hide\_ellipsis () ##

当节点名过长，不缩略显示。

## 1.185. hide\_ellipsis.jstree （ Event ⚡ ） ##

当节点名过长，不缩略显示时触发。

## 1.186. set\_icon (obj, icon) ##

设置节点的图标。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code></td> 
  </tr> 
  <tr> 
   <td><code>icon</code></td> 
   <td><code>String</code>&nbsp;新的图标名，可以是一个图标的文件路径，或 CSS 的 class 名。若使用图标文件路径，则应使用当前目录作为前缀<code>./</code>，否则都认为是 CSS 类名</td> 
  </tr> 
 </tbody> 
</table>

## 1.187. get\_icon (obj) ##

获取节点的图标。

## 1.188. hide\_icon (obj) ##

隐藏单个节点的图标。

<table> 
 <thead> 
  <tr> 
   <th>参数/返回</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>obj</code></td> 
   <td><code>mixed</code></td> 
  </tr> 
 </tbody> 
</table>

## 1.189. show\_icon (obj) ##

显示单个节点的图标。