jQuery EasyUI 數據網格與樹插件– Tree 樹

依賴

• draggable
• droppable

用法

樹（tree）定義在<ul> 元素中。 該標記可定義葉節點和子節點。 節點將是ul 列表內的<li> 元素。 下面演示了將被用於製作嵌套在ul 元素內的樹節點的元素。

<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 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#"
    }]
}]

異步樹

樹支持內置的異步加載模式，因此用戶可以創建一個空的樹，然後指定一個動態返回JSON 數據的服務器端，用於根據需求異步填充樹。 下面是一個實例：

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

樹是通過URL 'get_data.php' 加載的。 子節點依賴於父節點狀態被加載。 當展開一個關閉的節點時，如果該節點沒有子節點加載，它將通過上面定義的URL 向服務器發送節點的id 值作為名為'id' 的http 請求參數，以便檢索子節點。

請看從服務器返回的數據：

[{
    "id": 1,
    "text": "Node 1",
    "state": "closed",
    "children": [{
		"id": 11,
		"text": "Node 11"
    },{
		"id": 12,
		"text": "Node 12"
    }]
},{
    "id": 2,
    "text": "Node 2",
    "state": "closed"
}]

節點1 和節點2 是關閉的，當展開節點1 時，將直接展示它的子節點。 當展開節點2 時，將向服務器發送value(2) 以便檢索子節點。

本教程中的創建異步樹演示瞭如何編寫服務器代碼來根據需求返回樹的數據。

屬性

$('#tt').tree({
	data: [{
		text: 'Item1',
		state: 'closed',
		children: [{
			text: 'Item11'
		},{
			text: 'Item12'
		}]
	},{
		text: 'Item2'
	}]
});

$('#tt').tree({
	formatter:function(node){
		return node.text;
	}
});

事件

很多事件的回調函數需要'node' 參數，它包括下列屬性：

• id：綁定到節點的標識值。
• text：要顯示的文本。
• iconCls：用來顯示圖標的css class。
• checked：節點是否被選中。
• state：節點狀態，'open' 或'closed'。
• attributes：綁定到節點的自定義屬性。
• target：目標的DOM 對象。

$('#tt').tree({
	onClick: function(node){
		alert(node.text);  // alert node text property when clicked
	}
});

// right click node and then display the context menu
$('#tt').tree({
	onContextMenu: function(e, node){
		e.preventDefault();
		// select the node
		$('#tt').tree('select', node.target);
		// display context menu
		$('#mm').menu('show', {
			left: e.pageX,
			top: e.pageY
		});
	}
});

// the context menu is defined as below:
<div id="mm" class="easyui-menu" style="width:120px;">
	<div onclick="append()" data-options="iconCls:'icon-add'">Append</div>
	<div onclick="remove()" data-options="iconCls:'icon-remove'">Remove</div>
</div>

方法

var nodes = $('#tt').tree('getChecked');	// get checked nodes
var nodes = $('#tt').tree('getChecked', 'unchecked');	// get unchecked nodes
var nodes = $('#tt').tree('getChecked', 'indeterminate');	// get indeterminate nodes
var nodes = $('#tt').tree('getChecked', ['checked','indeterminate']);	// get checked and indeterminate nodes

// find a node and then select it
var node = $('#tt').tree('find', 12);
$('#tt').tree('select', node.target);

// append some nodes to the selected node
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'
		}]
	}]
});

var node = $('#tt').tree('getSelected');
if (node){
	$('#tt').tree('insert', {
		before: node.target,
		data: {
			id: 21,
			text: 'node text'
		}
	});
}

// update the selected node text
var node = $('#tt').tree('getSelected');
if (node){
	$('#tt').tree('update', {
		target: node.target,
		text: 'new text'
	});
}