jQuery EasyUI API 中文文档 - Tree树使用介绍

Posted 2020-07-25

Tree 能在 <ul> 元素里定义，此标记可以定义为叶节点和子节点。下面是一个示例： 

 1 <ul id="tt"> 
 2 <li> 
 3 <span>Folder</span> 
 4 <ul> 
 5 <li> 
 6 <span>Sub Folder 1</span> 
 7 <ul> 
 8 <li> 
 9 <span><a href="#">File 11</a></span> 
10 </li> 
11 <li> 
12 <span>File 12</span> 
13 </li> 
14 <li> 
15 <span>File 13</span> 
16 </li> 
17 </ul> 
18 </li> 
19 <li> 
20 <span>File 2</span> 
21 </li> 
22 <li> 
23 <span>File 3</span> 
24 </li> 
25 </ul> 
26 </li> 
27 <li> 
28 <span>File21</span> 
29 </li> 
30 </ul> 

 

Tree 也可以在一个空的 <ul> 元素里定义。 

1 <ul id="tt"></ul> 
2 
3 $(‘#tt‘).tree({ 
4 url:‘tree_data.json‘ 
5 }); 

 

树数据的格式（Tree data format） 
每个节点可以包含下列特性： 
id：节点的 id，它对于加载远程数据很重要。 
text：显示的节点文字。 
state：节点状态， ‘open‘ 或 ‘closed‘，默认是 ‘open‘。当设为 ‘closed‘ 时，此节点有子节点，并且将从远程站点加载它们。 
checked：指示节点是否被选中。 Indicate whether the node is checked selected. 
attributes：给一个节点追加的自定义属性。 
children：定义了一些子节点的节点数组。 
示例： 

[{ 
"id":1, 
"text":"Folder1", 
"iconCls":"icon-save", 
"children":[{ 
"text":"File1", 
"checked":true 
},{ 
"text":"Books", 
"state":"open", 
"attributes":{ 
"url":"/demo/book/abc", 
"price":100 
}, 
"children":[{ 
"text":"PhotoShop", 
"checked":true 
},{ 
"id": 8, 
"text":"Sub Bookds", 
"state":"closed" 
}] 
}] 
},{ 
"text":"Languages", 
"state":"closed", 
"children":[{ 
"text":"Java" 
},{ 
"text":"C#" 
}] 
}] 

 

特性

名称	类型	说明	默认值
url	string	获取远程数据的 URL 。	null
method	string	获取数据的 http method 。	post
animate	boolean	定义当节点展开折叠时是否显示动画效果。	false
checkbox	boolean	定义是否在每个节点前边显示 checkbox 。	false
cascadeCheck	boolean	定义是否级联检查。	true
onlyLeafCheck	boolean	定义是否只在叶节点前显示 checkbox 。	false
dnd	boolean	定义是否启用拖放。	false
data	array	加载的节点数据。	null

事件

很多事件的回调函数需要 ‘node‘ 函数，它包含下列特性：

• id：绑定到节点的标识值。
• text：显示的文字。
• checked：是否节点被选中。
• attributes：绑定到节点的自定义属性。
• target：目标的 DOM 对象。

名称	参数	说明
onClick	node	当用户点击一个节点时触发， node 参数包含下列特性： id：节点的 id text：节点的文字 checked：节点是否被选中 attributes：节点自定义属性 target：被点击目标的 DOM 对象
onDblClick	node	当用户双击一个节点时触发。
onBeforeLoad	node, param	当加载数据的请求发出前触发，返回 false 就取消加载动作。
onLoadSuccess	node, data	当数据加载成功时触发。
onLoadError	arguments	当数据加载失败时触发， arguments 参数与 jQuery.ajax 的‘error‘ 函数一样。.
onBeforeExpand	node	节点展开前触发，返回 false 就取消展开动作。
onExpand	node	当节点展开时触发。
onBeforeCollapse	node	节点折叠前触发，返回 false 就取消折叠动作。
onCollapse	node	当节点折叠时触发。
onCheck	node, checked	当用户点击 checkbox 时触发。
onBeforeSelect	node	节点被选中前触发，返回 false 就取消选择动作。
onSelect	node	当节点被选中时触发。
onContextMenu	e, node	当右键点击节点时触发。
onDrop	target, source, point	当节点被拖拽施放时触发。 target：DOM 对象，拖放的目标节点。 source：源节点。 point：表示拖放操作，可能是值是： ‘append‘、‘top‘ 或 ‘bottom‘。
onBeforeEdit	node	编辑节点前触发。
onAfterEdit	node	编辑节点后触发。
onCancelEdit	node	当取消编辑动作时触发。

方法

 

名称	参数	说明
options	none	返回树的 options。
loadData	data	加载树的数据。
getNode	target	获取指定的节点对象。
getData	target	获取指定的节点数据，包括它的子节点。
reload	target	重新加载树的数据。
getRoot	none	获取根节点，返回节点对象。
getRoots	none	获取根节点们，返回节点数组。
getParent	target	获取父节点， target 参数指节点的 DOM 对象。
getChildren	target	获取子节点， target 参数指节点的 DOM 对象。
getChecked	none	获取所有选中的节点。
getSelected	none	获取选中的节点并返回它，如果没有选中节点，就返回 null。
isLeaf	target	把指定的节点定义成叶节点， target 参数表示节点的 DOM 对象。
find	id	找到指定的节点并返回此节点对象。
select	target	选中一个节点， target 参数表示节点的 DOM 对象。
check	target	把指定节点设置为勾选。
uncheck	target	把指定节点设置为未勾选。
collapse	target	折叠一个节点， target 参数表示节点的 DOM 对象。
expand	target	展开一个节点， target 参数表示节点的 DOM 对象。
collapseAll	target	折叠所有的节点们。
expandAll	target	展开所有的节点们。
expandTo	target	从指定节点的根部展开。
append	param	追加一些子节点们到一个父节点， param 参数有两个特性： parent：DOM 对象，追加到的父节点，如果没有分配，则追加为根节点。 data：数组，节点们的数据。
toggle	target	切换节点的展开/折叠状态， target 参数表示节点的 DOM 对象。
insert	param	在指定节点的前边或后边插入一个节点， param 参数包含下列特性： before：DOM 对象，前边插入的节点。 after：DOM 对象，后边插入的节点。 data：对象，节点数据。
remove	target	移除一个节点和它的子节点们， target 参数表示节点的 DOM 对象。
pop	target	弹出一个节点和它的子节点们，此方法和 remove 一样，但是返回了移除的节点数据。
update	param	跟心指定的节点， param 参数有下列特性： target（DOM 对象，被更新的节点）、id、text、iconCls、checked、等等。
enableDnd	none	启用拖放功能。
disableDnd	none	禁用拖放功能。
beginEdit	nodeEl	开始编辑节点。
endEdit	nodeEl	结束编辑节点。
cancelEdit	nodeEl	取消编辑节点。