Jquery easyui tree的使用

这个ui用的一切都是json数据。树也是如此！

后台需要返回与格式匹配的json数据才能正确加载树。

页面定义一个ui：

[html] view plaincopyprint?
  1. <ul id="messageInfoAddTree" class="easyui-tree" checkbox="true" data-options="lines:true" style="height:94%"></ul>  

JS访问后台：

[javascript] view plaincopyprint?
  1. //人员树  
  2.     $('#messageInfoAddTree').tree({      
  3.         url: "controller/crmMessageInfo/selectEditTree.json?rid=-1",  
  4.         loadFilter: function(data){     
  5.             return data;        
  6.         }       
  7.     });   

后台实体Bean中需要的属性：

[java] view plaincopyprint?
  1. public class EmployeeTree {  
  2.     private Integer id;  //人员编号  
  3.     private String text; //人员名称  
  4.     private Boolean checked = false; //是否选中  
  5.     private List<EmployeeTree> children; //子节点  
  6. }  

按照此种格式填充数据就能得到下面的结果：

获取已勾选的节点数据：

[javascript] view plaincopyprint?
  1. var nodes = $('#messageInfoAddTree').tree('getChecked');  

还有一个功能，就是让tree的所有节点都勾选上或者取消勾选，在api中找了一下有一个方法：

check target 选中指定节点。

那我们只能是选中根节点后，实现全选。

 

getRoot none 获取根节点，返回节点对象。

全选：

[javascript] view plaincopyprint?
  1. var root = $('#messageInfoAddTree').tree('getRoot');  
  2. $("#messageInfoAddTree").tree('check',root.target);  

取消选择：

[javascript] view plaincopyprint?
  1. var root = $('#messageInfoAddTree').tree('getRoot');  
  2. $("#messageInfoAddTree").tree('uncheck',root.target);  



Jquery easyui tree Api：

Tree（树）

使用$.fn.tree.defaults重写默认值对象。

树控件在web页面中一个将分层数据以树形结构进行显示。它提供用户展开、折叠、拖拽、编辑和异步加载等功能。

 

依赖关系

使用案例

树控件使用<ul>元素定义。标签能够定义分支和子节点。节点都定义在<ul>列表内的<li>元素中。以下显示的元素将被用作树节点嵌套在<ul>元素中。

 
  1. <ul id="tt" class="easyui-tree">  
  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>  

 

树控件也可以定义在一个空<ul>元素中并使用Javascript加载数据。

 
  1. <ul id="tt"></ul>  

 

 
  1. $('#tt').tree({   
  2.     url:'tree_data.json'  
  3. });  

 

使用loadFilter函数处理来自Web Services的JSON数据。

 
  1. $('#tt').tree({   
  2.     url: ...,   
  3.     loadFilter: function(data){   
  4.         if (data.d){   
  5.             return data.d;   
  6.         } else {   
  7.             return data;   
  8.         }   
  9.     }   
  10. });  


 

树控件数据格式化

每个节点都具备以下属性：

  • id：节点ID，对加载远程数据很重要。
  • text：显示节点文本。
  • state：节点状态，'open' 或 'closed'，默认：'open'。如果为'closed'的时候，将不自动展开该节点。
  • checked：表示该节点是否被选中。
  • attributes: 被添加到节点的自定义属性。
  • children: 一个节点数组声明了若干节点。

一些案例：

 
  1. [{   
  2.     "id":1,   
  3.     "text":"Folder1",   
  4.     "iconCls":"icon-save",   
  5.     "children":[{   
  6.         "text":"File1",   
  7.         "checked":true  
  8.     },{   
  9.         "text":"Books",   
  10.         "state":"open",   
  11.         "attributes":{   
  12.             "url":"/demo/book/abc",   
  13.             "price":100   
  14.         },   
  15.         "children":[{   
  16.             "text":"PhotoShop",   
  17.             "checked":true  
  18.         },{   
  19.             "id": 8,   
  20.             "text":"Sub Bookds",   
  21.             "state":"closed"  
  22.         }]   
  23.     }]   
  24. },{   
  25.     "text":"Languages",   
  26.     "state":"closed",   
  27.     "children":[{   
  28.         "text":"Java"  
  29.     },{   
  30.         "text":"C#"  
  31.     }]   
  32. }]  


 

异步树控件

树控件内建异步加载模式的支持，用户先创建一个空的树，然后指定一个服务器端，执行检索后动态返回JSON数据来填充树并完成异步请求。例子如下：

 
  1. <ul class="easyui-tree" data-options="url:'get_data.php'"></ul>  

 

树控件读取URL。子节点的加载依赖于父节点的状态。当展开一个封闭的节点，如果节点没有加载子节点，它将会把节点id的值作为http请求参数并命名为'id'，通过URL发送到服务器上面检索子节点。

下面是从服务器端返回的数据。

 
  1. [{   
  2.     "id": 1,   
  3.     "text": "Node 1",   
  4.     "state": "closed",   
  5.     "children": [{   
  6.         "id": 11,   
  7.         "text": "Node 11"  
  8.     },{   
  9.         "id": 12,   
  10.         "text": "Node 12"  
  11.     }]   
  12. },{   
  13.     "id": 2,   
  14.     "text": "Node 2",   
  15.     "state": "closed"  
  16. }]  

 

节点1和节点2是封闭的，当展开节点1的时候将直接显示它的子节点。当展开节点2的时候它将发送值(2)到服务器获取子节点。

 

属性

属性名属性值类型描述默认值
url string 检索远程数据的URL地址。 null
method string 检索数据的HTTP方法。（POST / GET） post
animate boolean 定义节点在展开或折叠的时候是否显示动画效果。 false
checkbox boolean 定义是否在每一个借点之前都显示复选框。 false
cascadeCheck boolean 定义是否层叠选中状态。 true
onlyLeafCheck boolean 定义是否只在末级节点之前显示复选框。 false
lines boolean 定义是否显示树控件上的虚线。 false
dnd boolean 定义是否启用拖拽功能。 false
data array 节点数据加载。 
$('#tt').tree({
	data: [{
		text: 'Item1',
		state: 'closed',
		children: [{
			text: 'Item11'
		},{
			text: 'Item12'
		}]
	},{
		text: 'Item2'
	}]
});
null
formatter function(node) 定义如何渲染节点的文本。

代码示例：

$('#tt').tree({
	formatter:function(node){
		return node.text;
	}
});
 false
loader function(param,success,error) 定义如何从远程服务器加载数据。返回false可以忽略本操作。该函数具备以下参数：
param：发送到远程服务器的参数对象。
success(data)：当检索数据成功的时候调用的回调函数。
error()：当检索数据失败的时候调用的回调函数。		 json loader
loadFilter function(data,parent) 返回过滤过的数据进行展示。返回数据是标准树格式。该函数具备以下参数：
data：加载的原始数据。
parent: DOM对象，代表父节点。		  

 

事件

很多事件的回调函数都包含'node'参数，其具备如下属性：

  • id：绑定节点的标识值。
  • text：显示的节点文本。
  • iconCls：显示的节点图标CSS类ID。
  • checked：该节点是否被选中。
  • state：节点状态，'open' 或 'closed'。
  • attributes：绑定该节点的自定义属性。
  • target：目标DOM对象。
事件名事件参数描述
onClick node

在用户点击一个节点的时候触发。

代码示例： 

$('#tt').tree({
	onClick: function(node){
		alert(node.text);  // 在用户点击的时候提示
	}
});
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 在节点折叠的时候触发。
onBeforeCheck node, checked 在用户点击勾选复选框之前触发，返回false可以取消选择动作。（该事件自1.3.1版开始可用）
onCheck node, checked 在用户点击勾选复选框的时候触发。
onBeforeSelect node 在用户选择一个节点之前触发，返回false可以取消选择动作。
onSelect node 在用户选择节点的时候触发。
onContextMenu e, node

在右键点击节点的时候触发。

代码示例： 

// 右键点击节点并显示快捷菜单
$('#tt').tree({
	onContextMenu: function(e, node){
		e.preventDefault();
		// 查找节点
		$('#tt').tree('select', node.target);
		// 显示快捷菜单
		$('#mm').menu('show', {
			left: e.pageX,
			top: e.pageY
		});
	}
});

// 右键菜单定义如下：
<div id="mm" class="easyui-menu" style="width:120px;">
	<div onclick="append()" data-options="iconCls:'icon-add'">追加</div>
	<div onclick="remove()" data-options="iconCls:'icon-remove'">移除</div>
</div>
onBeforeDrag node 在开始拖动节点之前触发，返回false可以拒绝拖动。（该事件自1.3.2版开始可用）
onStartDrag node 在开始拖动节点的时候触发。（该事件自1.3.2版开始可用）
onStopDrag node 在停止拖动节点的时候触发。（该事件自1.3.2版开始可用）
onDragEnter target, source 在拖动一个节点进入到某个目标节点并释放的时候触发，返回false可以拒绝拖动。
target：释放的目标节点元素。
source：开始拖动的源节点。
（该事件自1.3.2版开始可用）
onDragOver target, source 在拖动一个节点经过某个目标节点并释放的时候触发，返回false可以拒绝拖动。
target：释放的目标节点元素。
source：开始拖动的源节点。
（该事件自1.3.2版开始可用）
onDragLeave target, source 在拖动一个节点离开某个目标节点并释放的时候触发，返回false可以拒绝拖动。
target：释放的目标节点元素。
source：开始拖动的源节点。
（该事件自1.3.2版开始可用）
onBeforeDrop target, source, point 在拖动一个节点之前触发，返回false可以拒绝拖动。
target：释放的目标节点元素。
source：开始拖动的源节点。
point：表示哪一种拖动操作，可用值有：'append','top' 或 'bottom'。
（该事件自1.3.3版开始可用）		  
onDrop target, source, point 当节点位置被拖动时触发。
target：DOM对象，需要被拖动动的目标节点。
source：源节点。
point：表示哪一种拖动操作，可用值有：'append','top' 或 'bottom'。
onBeforeEdit node 在编辑节点之前触发。
onAfterEdit node 在编辑节点之后触发。
onCancelEdit node 在取消编辑操作的时候触发。

 

方法

方法名方法参数描述
options none 返回树控件属性。
loadData data 读取树控件数据。
getNode target 获取指定节点对象。
getData target 获取指定节点数据，包含它的子节点。
reload target 重新载入树控件数据。
getRoot none 获取根节点，返回节点对象。
getRoots none 获取所有根节点，返回节点数组。
getParent target 获取父节点，'target'参数代表节点的DOM对象。
getChildren target 获取所有子节点，'target'参数代表节点的DOM对象。
getChecked state 获取所有选中的节点。'state'可用值有：'checked','unchecked','indeterminate'。如果'state'未指定，将返回'checked'节点。

代码示例：

var nodes = $('#tt').tree('getChecked');	// get checked nodes
var nodes = $('#tt').tree('getChecked', 'unchecked');	// 获取未选择节点
var nodes = $('#tt').tree('getChecked', 'indeterminate');	// 获取不确定的节点
译者注：（1.3.4新增获取方式）

var nodes = $('#tt').tree('getChecked', ['unchecked','indeterminate']);
getSelected none 获取选择节点并返回它，如果未选择则返回null。
isLeaf target 判断指定的节点是否是叶子节点，target参数是一个节点DOM对象。
find id

查找指定节点并返回节点对象。

代码示例： 

// 查找一个节点并选择它
var node = $('#tt').tree('find', 12);
$('#tt').tree('select', node.target);
select target 选择一个节点，'target'参数表示节点的DOM对象。
check target 选中指定节点。
uncheck target 取消选中指定节点。
collapse target 折叠一个节点，'target'参数表示节点的DOM对象。
expand target 展开一个节点，'target'参数表示节点的DOM对象。在节点关闭或没有子节点的时候，节点ID的值(名为'id'的参数)将会发送给服务器
请求子节点的数据。
collapseAll target 折叠所有节点。
expandAll target 展开所有节点。
expandTo target 打开从根节点到指定节点之间的所有节点。
scrollTo target 滚动到指定节点。（该方法自1.3.4版开始可用）
append param

追加若干子节点到一个父节点，param参数有2个属性：
parent：DOM对象，将要被追加子节点的父节点，如果未指定，子节点将被追加至根节点。
data：数组，节点数据。

代码示例：

// 追加若干个节点并选中他们
var selected = $('#tt').tree('getSelected');
$('#tt').tree('append', {
	parent: selected.target,
	data: [{
		id: 23,
		text: 'node23'
	},{
		text: 'node24',
		state: 'closed',
		children: [{
			text: 'node241'
		},{
			text: 'node242'
		}]
	}]
});
toggle target 打开或关闭节点的触发器，target参数是一个节点DOM对象。
insert param 在一个指定节点之前或之后插入节点，'param'参数包含如下属性：
before：DOM对象，在某个节点之前插入。
after：DOM对象，在某个节点之后插入。
data：对象，节点数据。

下面的代码展示了如何将一个新节点插入到选择的节点之前：

var node = $('#tt').tree('getSelected');
if (node){
	$('#tt').tree('insert', {
		before: node.target,
		data: {
			id: 21,
			text: 'node text'
		}
	});
}
译者注：（1.3.4新增获取方式）
var node = $('#tt').tree('getSelected');
if (node){
	$('#tt').tree('insert', {
		before: node.target,
		data: [{
		    id: 23,
		    text: 'node23'
	                },{
	    	    text: 'node24',
	                    state: 'closed',
		    children: [{
			text: 'node241'
		    },{
			text: 'node242'
		    }]
	                }]
	});
}
remove target 移除一个节点和它的子节点，'target'参数是该节点的DOM对象。
pop target 移除一个节点和它的子节点，该方法跟remove方法一样，不同的是它将返回被移除的节点数据。
update param 更新指定节点。'param'参数包含以下属性：
target(DOM对象，将被更新的目标节点)，id，text，iconCls，checked等。

代码示例：

// 更新选择的节点文本
var node = $('#tt').tree('getSelected');
if (node){
	$('#tt').tree('update', {
		target: node.target,
		text: 'new text'
	});
}
enableDnd none 启用拖拽功能。
disableDnd none 禁用拖拽功能。
beginEdit target 开始编辑一个节点。
endEdit target 结束编辑一个节点。
cancelEdit target 取消编辑一个节点。
posted @ 2015-01-15 12:00  《从容面对》  阅读(2048)  评论(0)  编辑  收藏  举报