JQuery EasyUI Tree

Tree

树(tree)在网页中以树形结构显示分层数据。它向用户提供展开、折叠、拖拽、编辑和异步加载功能。
在这里插入图片描述
JQuery EasyUI需要引入的文件有如下4个:

<!-- jquery核心库 -->
<script type="text/javascript" src="easyui/jquery.min.js"></script> 

<!-- easyui核心库 --> 
<script type="text/javascript" src="easyui/jquery.easyui.min.js"></script>

<!-- easyui核心UI文件 css -->  
<link href="easyui/themes/default/easyui.css" rel="stylesheet" type="text/css"/>

<!-- easyui图标 -->
<link href="easyui/themes/icon.css" rel="stylesheet" type="text/css"/>

JQuery核心库一定要放在easyui核心库前面引入,不然JQuery.easyui.min.js中会报错:JQuery is not defined。

有的时候,我们需要进行国际化,比如一些提醒、日历等,就需要引入easyui的国际化文件,代码如下:

<!-- Easyui国际化文件 --> 
<script type="text/javascript" src="../resource/js/jquery-easyui-1.5/locale/easyui-lang-zh_CN.js"></script>

Tree的定义
树(tree)定义在 ul 元素中。该标记可定义叶节点和子节点。节点将是 ul 列表内的 li 元素。

<ul id="tt" class="easyui-tree">
    <li>
		<span>Folder</span>
		<ul>
			<li>
				<span>Sub Folder 1</span>
				<ul>
					<li><span><a href="#">File 11</a></span></li>
					<li><span>File 12</span></li>
					<li><span>File 13</span></li>
				</ul>
			</li>
			<li><span>File 2</span></li>
			<li><span>File 3</span></li>
		</ul>
	</li>
    <li><span>File21</span></li>
</ul>

树(Tree)也可以在一个空的 ul 元素中定义,可使用 javascript 加载数据。

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


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

使用 loadFilter 来处理来自 ASP.NET web 服务的 json 数据。

$('#tt').tree({
    url: ...,
    loadFilter: function(data){
		if (data.d){
			return data.d;
		} else {
			return data;
		}
    }
});

自定义Tree

<div data-options="region:'west',split:true" title='系统导航'
		style="width: 200px; overflow: hidden; overflow-y: auto; padding: 0px; background-color: #5497d3">
		<div class="well well-small">
			<ul id="layout_west_tree"></ul>
		</div>
	</div>

Tree的数据格式(Tree Data Format)
每个节点可以包括下列属性:
id:节点的 id,它对于加载远程数据很重要。
text:要显示的节点文本。
state:节点状态,‘open’ 或 ‘closed’,默认是 ‘open’。当设置为 ‘closed’ 时,该节点有子节点,并且将从远程站点加载它们。
checked:指示节点是否被选中。
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#"
    }]
}]

自定义的Tree实体类

public class Tree implements Serializable
{
    private static  long serialVersionUID = 980682543891282923L;
    private Long id;
    private String code;
    private String text;
    private String state;
    private boolean checked;
    private Object attributes;
    private List<Tree> children;
    private String iconCls;
    private String pcode;
    private String pid;
    public Tree() {
        this.state = "open";
        this.checked = false;
    }
    setter和getter方法略
    }

自定义返回的数据结果格式

 @Override
    public List<Tree> findTree( SysUser sysUser) {
         List<Tree> trees = new ArrayList<Tree>();
        if (!sysUser.getLoginname().equals("admin")) {
            List<SysResource> resourceIdLists = null;
             List<UserRole> roleIdList = this.roleService.findUserRoleByUserId(sysUser.getId());
            for ( UserRole userRole : roleIdList) {
                SysRole sysRole = new SysRole();
                sysRole.setId(userRole.getRole_id());
                sysRole = this.publicService.selectObj("sys_role", "", "id", sysRole);
                if (sysRole.getStatus() == 0) {
                    resourceIdLists = this.resourceMapper.findResourceListByRoleIdAndType(userRole.getRole_id(), Config.RESOURCE_MENU.toString(), "");
                }
            }
            for ( SysResource sysResource : resourceIdLists) {
                if (sysResource != null && sysResource.getPid() == null) {
                     Tree treeOne = new Tree();
                    treeOne.setId(sysResource.getId());
                    treeOne.setText(sysResource.getName());
                    treeOne.setIconCls(sysResource.getIcon());
                    treeOne.setAttributes(sysResource.getUrl());
                     List<Tree> tree = new ArrayList<Tree>();
                    for ( SysResource resourceTwo : resourceIdLists) {
                        if (resourceTwo.getPid() != null && sysResource.getId() == (long)resourceTwo.getPid()) {
                             Tree treeTwo = new Tree();
                            treeTwo.setId(resourceTwo.getId());
                            treeTwo.setText(resourceTwo.getName());
                            treeTwo.setIconCls(resourceTwo.getIcon());
                            treeTwo.setAttributes(resourceTwo.getUrl());
                            tree.add(treeTwo);
                        }
                    }
                    treeOne.setChildren(tree);
                    trees.add(treeOne);
                }
            }
            return trees;
        }

Tree显示数据

layout_west_tree = $('#layout_west_tree').tree(
				{
					url : '${path }/admin/resource/tree',
					parentField : 'pid',
					lines : false,
					onClick : function(node) {
						var url = node.attributes;
						url = url == null ? "" : url;
						if (url.indexOf("http") >= 0) {   //indexOf() 方法可返回某个指定的字符串值在字符串中首次出现的位置
							addTab({
								url : url,
								title : node.text,
								iconCls : node.iconCls
							});
						} else if (url) {
							url = '${path }' + node.attributes;
							addTab({
								url : url,
								title : node.text,
								iconCls : node.iconCls
							});
						} else {
							layout_west_tree.tree('toggle', node.target);   //切换节点的展开/折叠状态,target 参数表示节点的 DOM 对象
						}

				},
				onLoadSuccess : function(node, data) {
					$(this).tree('collapseAll');   //折叠所有节点。
				},
				onExpand : function(node) {  //在节点展开的时候触发,判断点击的是不是同个节点,如果是就关闭同个节点。不是就打开新节点,找到并关闭上次节点。
					if (layout_west_tree_prenode != node.id) {
						var preNode = layout_west_tree.tree('find', layout_west_tree_prenode); //查找指定节点并返回节点对象。
						if (preNode != null) {
							layout_west_tree.tree('collapse', preNode.target);  //折叠一个节点,'target'参数表示节点的DOM对象
						}
					}
					layout_west_tree_prenode = node.id;
				}
			});

Tree的属性

名称类型描述默认值
urlstring获取远程数据的 URL 。null
methodstring检索数据的 http 方法(method)。post
animateboolean定义当节点展开折叠时是否显示动画效果。false
checkboxboolean定义是否在每个节点前边显示复选框。false
cascadeCheckboolean定义是否级联检查。true
onlyLeafCheckboolean定义是否只在叶节点前显示复选框。false
linesboolean定义是否显示树线条。false
dndboolean定义是否启用拖放。false
dataarray要加载的节点数据。
      
      
  1. $('#tt').tree({
  2. data: [{
  3. text: 'Item1',
  4. state: 'closed',
  5. children: [{
  6. text: 'Item11'
  7. },{
  8. text: 'Item12'
  9. }]
  10. },{
  11. text: 'Item2'
  12. }]
  13. });
null
formatterfunction(node)定义如何呈现节点文本。
代码实例:
      
      
  1. $('#tt').tree({
  2. formatter:function(node){
  3. return node.text;
  4. }
  5. });
loaderfunction(param,success,error)定义如何从远程服务器加载数据。返回 false 则取消该动作。该函数有下列参数:
param:要传递到远程服务器的参数对象。
success(data):当检索数据成功时调用的回调函数。
error():当检索数据失败时调用的回调函数。
json loader
loadFilterfunction(data,parent)返回要显示的过滤数据。返回数据时以标准树格式返回的。该函数有下列参数:
data:要加载的原始数据。
parent:DOM 对象,表示父节点。

Tree的事件

很多事件的回调函数需要 'node' 参数,它包括下列属性:

  • id:绑定到节点的标识值。
  • text:要显示的文本。
  • iconCls:用来显示图标的 css class。
  • checked:节点是否被选中。
  • state:节点状态,'open' 或 'closed'。
  • attributes:绑定到节点的自定义属性。
  • target:目标的 DOM 对象。
名称参数描述
onClicknode当用户点击一个节点时触发。代码实例:
      
      
  1. $('#tt').tree({
  2. onClick: function(node){
  3. alert(node.text); // alert node text property when clicked
  4. }
  5. });
onDblClicknode当用户双击一个节点时触发。
onBeforeLoadnode, param当加载数据的请求发出前触发,返回 false 则取消加载动作。
onLoadSuccessnode, data当数据加载成功时触发。
onLoadErrorarguments当数据加载失败时触发,arguments 参数与 jQuery.ajax 的 'error' 函数一样。
onBeforeExpandnode节点展开前触发,返回 false 则取消展开动作。
onExpandnode当节点展开时触发。
onBeforeCollapsenode节点折叠前触发,返回 false 则取消折叠动作。
onCollapsenode当节点折叠时触发。
onBeforeChecknode, checked当用户点击复选框前触发,返回 false 则取消该选中动作。该事件自版本 1.3.1 起可用。
onChecknode, checked当用户点击复选框时触发。
onBeforeSelectnode节点被选中前触发,返回 false 则取消选择动作。
onSelectnode当节点被选中时触发。
onContextMenue, node当右键点击节点时触发。代码实例:
      
      
  1. // right click node and then display the context menu
  2. $('#tt').tree({
  3. onContextMenu: function(e, node){
  4. e.preventDefault();
  5. // select the node
  6. $('#tt').tree('select', node.target);
  7. // display context menu
  8. $('#mm').menu('show', {
  9. left: e.pageX,
  10. top: e.pageY
  11. });
  12. }
  13. });
  14.  
  15. // the context menu is defined as below:
  16. <div id="mm" class="easyui-menu" style="width:120px;">
  17. <div onclick="append()" data-options="iconCls:'icon-add'">Append</div>
  18. <div οnclick="remove()" data-options="iconCls:'icon-remove'">Remove</div>
  19. </div>
onBeforeDragnode当节点的拖拽开始时触发,返回 false 则禁止拖拽。该事件自版本 1.3.2 起可用。
onStartDragnode当开始拖拽节点时触发。该事件自版本 1.3.2 起可用。
onStopDragnode当停止拖拽节点时触发。该事件自版本 1.3.2 起可用。
onDragEntertarget, source当节点被拖拽进入某个允许放置的目标节点时触发,返回 false 则禁止放置。
target:被放置的目标节点元素。
source:被拖拽的源节点。
该事件自版本 1.3.2 起可用。
onDragOvertarget, source当节点被拖拽到允许放置的目标节点上时触发,返回 false 则禁止放置。
target:被放置的目标节点元素。
source:被拖拽的源节点。
该事件自版本 1.3.2 起可用。
onDragLeavetarget, source当节点被拖拽离开允许放置的目标节点时触发。
target:被放置的目标节点元素。
source:被拖拽的源节点。
该事件自版本 1.3.2 起可用。
onBeforeDroptarget,source,point节点被放置之前触发,返回 false 则禁止放置。
target:DOM 对象,放置的目标节点。
source:源节点。
point:表示放置操作,可能的值是:'append'、'top' 或 'bottom'。
该事件自版本 1.3.2 起可用。
onDroptarget,source,point当节点被放置时触发。 target:DOM 对象,放置的目标节点。
source:源节点。
point:表示放置操作,可能的值是:'append'、'top' 或 'bottom'。
onBeforeEditnode编辑节点前触发。
onAfterEditnode编辑节点后触发。
onCancelEditnode当取消编辑动作时触发。

Tree的方法

名称参数描述
optionsnone返回树的选项(options)。
loadDatadata加载树的数据。
getNodetarget获取指定的节点对象。
getDatatarget获取指定的节点数据,包括它的子节点。
reloadtarget重新加载树的数据。
getRootnone获取根节点,返回节点对象。
getRootsnone获取根节点,返回节点数组。
getParenttarget获取父节点,target 参数表示节点的 DOM 对象。
getChildrentarget获取子节点, target 参数表示节点的 DOM 对象。
getCheckedstate获取选中的节点。状态可用值有:'checked'、'unchecked'、'indeterminate'。如果状态未分配,则返回 'checked' 节点。
代码实例:
      
      
  1. var nodes = $('#tt').tree('getChecked'); // get checked nodes
  2. var nodes = $('#tt').tree('getChecked', 'unchecked'); // get unchecked nodes
  3. var nodes = $('#tt').tree('getChecked', 'indeterminate'); // get indeterminate nodes
  4. var nodes = $('#tt').tree('getChecked', ['checked','indeterminate']); // get checked and indeterminate nodes
getSelectednone获取选中的节点并返回它,如果没有选中节点,则返回 null。
isLeaftarget把指定的节点定义成叶节点,target 参数表示节点的 DOM 对象。
findid找到指定的节点并返回该节点对象。代码实例:
      
      
  1. // find a node and then select it
  2. var node = $('#tt').tree('find', 12);
  3. $('#tt').tree('select', node.target);
selecttarget选中一个节点,target 参数表示节点的 DOM 对象。
checktarget把指定节点设置为勾选。
unchecktarget把指定节点设置为未勾选。
collapsetarget折叠一个节点,target 参数表示节点的 DOM 对象。
expandtarget展开一个节点,target 参数表示节点的 DOM 对象。当节点关闭且没有子节点时,节点的 id 值(名为 'id' 参数)将被发送至服务器以请求子节点数据。
collapseAlltarget折叠所有的节点。
expandAlltarget展开所有的节点。
expandTotarget从根部展开一个指定的节点。
scrollTotarget滚动到指定节点。该方法自版本 1.3.4 起可用。
appendparam追加一些子节点到一个父节点,param 参数有两个属性:
parent:DOM 对象,要追加到的父节点,如果没有分配,则追加为根节点。
data:数组,节点的数据。

代码实例:
      
      
  1. // append some nodes to the selected node
  2. var selected = $('#tt').tree('getSelected');
  3. $('#tt').tree('append', {
  4. parent: selected.target,
  5. data: [{
  6. id: 23,
  7. text: 'node23'
  8. },{
  9. text: 'node24',
  10. state: 'closed',
  11. children: [{
  12. text: 'node241'
  13. },{
  14. text: 'node242'
  15. }]
  16. }]
  17. });
toggletarget切换节点的展开/折叠状态,target 参数表示节点的 DOM 对象。
insertparam在指定节点的前边或后边插入一个节点,param 参数包括下列属性:
before:DOM 对象,前边插入的节点。
after:DOM 对象,后边插入的节点。
data:对象,节点数据。

下面的代码演示了如何在选中节点之前插入一个新的节点:
      
      
  1. var node = $('#tt').tree('getSelected');
  2. if (node){
  3. $('#tt').tree('insert', {
  4. before: node.target,
  5. data: {
  6. id: 21,
  7. text: 'node text'
  8. }
  9. });
  10. }
removetarget移除一个节点和它的子节点,target 参数表示节点的 DOM 对象。
poptarget弹出一个节点和它的子节点,该方法和 remove 一样,但是返回了移除的节点数据。
updateparam更新指定的节点,'param' 参数有下列属性:
target(DOM 对象,要被更新的节点)、id、text、iconCls、checked,等等。

代码实例:
      
      
  1. // update the selected node text
  2. var node = $('#tt').tree('getSelected');
  3. if (node){
  4. $('#tt').tree('update', {
  5. target: node.target,
  6. text: 'new text'
  7. });
  8. }
enableDndnone启用拖放功能。
disableDndnone禁用拖放功能。
beginEdittarget开始编辑节点。
endEdittarget结束编辑节点。
cancelEdittarget取消编辑节点。
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值