TreePanel的各项属性

作者： 花猫.NET  来源： 博客园  发布时间：2011-01-08 22:29  阅读：107 次   原文链接   [收藏]  

1、Ext.tree.TreePanel
主要配置项：
root：树的根节点。
rootVisible：是否显示根节点，默认为true。
useArrows：是否在树中使用Vista样式箭头，默认为false。
lines：是否显示树线，默认为true。
loader：树节点的加载器，默认为Ext.tree.TreeLoader。
selModel：树的选择模式，默认为Ext.tree.DefaultSelectionModel。
pathSeparator：树节点路径的分隔符，默认为“/”。
singleExpand：是否一次只展开树中的一个节点，默认为true。
requestMethod：请求方法，可选值有POST、GET。
containerScroll：是否将树形面板注册到滚动管理器ScrollManager中。
autoScroll：当内容超过预设的高度时自动出现滚动条。
draggable：是否允许拖曳。
enableDD：设置树的节点是否可以拖动。
主要方法：
collapseAll()：收缩所有树节点
expandAll()：展开所有树节点
getRootNode()：获取根节点
getNodeById(String id)：获取指定id的节点
expand( [Boolean deep], [Boolean anim], [Function callback], [Object scope] )
expandPath( String path, [String attr], [Function callback] )
getChecked( [String attribute], [TreeNode startNode] )
selectPath( String path, [String attr], [Function callback] )
getSelectionModel()：
2、Ext.data.Node
主要配置项：
id：节点id
leaf：当前节点是否为叶子节点
主要属性：
id：节点id
attributes：节点属性的集合
parentNode：当前节点的父节点
childNodes：当前节点所有子节点组成的数组
firstChild：当前节点的第一个直接子节点，如果没有则为null值
lastChild：当前节点的最后一个直接子节点，如果没有则为null值
nextSibling：当前节点的下一个兄弟节点，如果没有则为null值
previousSibling：当前节点的前一个兄弟节点，如果没有则为null值
主要方法：
appendChild( Node/Array node )：追加新的子节点
bubble( Function fn, [Object scope], [Array args] )：从当前节点开始向上迭代调用指定函数，如果指定函数返回false则将终止迭代。
args：传入函数中的参数，默认为当前节点
cascade( Function fn, [Object scope], [Array args] )：从当前节点开始向下迭代调用指定函数，如果指定函数返回false则将终止迭代。
contains( Node node )：当前节点是否包含指定子节点。
eachChild( Function fn, [Object scope], [Array args] )：迭代当前节点的所有子节点调用指定函数，如果指定函数返回false则将终止迭代。
findChild( String attribute, Mixed value )：查找具有指定属性的第一个子节点。
findChildBy( Function fn, [Object scope] )：根据自定义函数查找第一个符合要求的子节点，如果自定义函数返回true则说明匹配成功。
getDepth()：取得当前节点的深度，根节点的深度为0
getOwnerTree()：取得当前节点所在树。
getPath( [String attr] )：取得当前节点对应的路径，这个路径在程序中可用于展开或者选择节点。
attr：用于查找路径的属性，默认为节点id
hasChildNodes()：是否有子节点
indexOf( Node node )：取得指定子节点的索引值，未找到返回-1。
insertBefore( Node node, Node refNode )：在当前节点的指定子节点之前插入一个新的子节点。
node：要插入的新节点
isAncestor( Node node )：判断指定节点是否为当前节点的父节点（可以是任何一级中的父节点）。
isFirst()：是否为父节点的第一个子节点。
isLast()：是否为父节点的最后一个子节点。
isLeaf()：是否为叶子节点。
item( Number index )：取得指定索引的子节点。
remove()：从父节点中删除当前节点。
removeChild( Node node )：删除当前节点的指定子节点。
replaceChild( Node newChild, Node oldChild )：用新的子节点替换当前节点的指定子节点。
sort( Function fn, [Object scope] )：用指定的排序函数为当前节点的子节点进行排序。
3、Ext.tree.TreeNode
主要配置项：
text：节点上的文本信息
qtip：节点上的提示信息
icon：节点图标对应的路径
iconCls：应用到节点图标上的样式
checked：当前节点的选择状态
true：在节点前显示一个选中状态的复选框
false：在节点前显示一个未选中状态的复选框
不指定该值：不显示任何复选框
href：节点的连接属性，默认为#
hrefTarget：显示节点连接的目标框架
editable：是否允许编辑，默认为true
expanded：是否展开节点，默认为false
disabled：是否禁用节点，默认为false
singleClickExpand：是否通过单击方式展开节点
allowChildren：是否允许当前节点具有子节点，默认为true
expandable：当不含子节点时，是否总显示一个加减图标，默认为false
uiProvider：节点的UI类，默认为Ext.tree.TreeNodeUI
主要属性：
text：节点上的文本信息
disabled：当前节点是否被禁用
主要方法：
collapse( [Boolean deep], [Boolean anim], [Function callback], [Object scope] )：收缩当前节点
deep：是否级联收缩全部子节点
collapseChildNodes( [Boolean deep] )：收缩所有子节点
disable()：禁用当前节点
enable()：启用当前节点
ensureVisible( [Function callback], [Object scope] )：确保所有父节点都是展开的
expand( [Boolean deep], [Boolean anim], [Function callback], [Object scope] )：展开当前节点
expandChildNodes( [Boolean deep] )：展开所有子节点
isExpanded()：当前节点是否展开
isSelected()：当前节点是否被选中
select()：选择当前节点
setText( String text )：设置当前的文本
toggle()：切换当前节点的展开和收缩状态
unselect()：取消对当前节点的选择
getUI()：取得节点的UI对象
4、Ext.tree.AsyncTreeNode
主要配置项：
loader：当前节点的树加载器，默认使用树中配置的树加载器
主要方法：
isLoaded()：当前节点是否已经加载数据
reload( Function callback, [Object scope] )：重新加载节点数据，并调用回调函数
5、Ext.tree.TreeNodeUI
主要方法：
getAnchor()：从节点的UI中获取焦点的<a>元素
getIconEl()：获取图标的<img>元素
getTextEl()：获取文本节点
addClass( String/Array className )：
removeClass( String/Array className )：
hide()：
show()：
isChecked()：取得节点的选择状态，如果当前节点没有复选框则函数返回false
toggleCheck( Boolean (optional) )：设置节点复选框的选择状态
6、Ext.tree.TreeNodeUI作为树形节点的视图，我们可以通过node.ui的方式获得某个Ext.tree.TreeNode实例对应的Ext.tree.TreeNodeUI。

主要函数：

addClass( )给节点增加样式；

removeClass（）给节点删除样式；

getAnchor（）获得页面上与树形对应的<a>标签；

getIconEl（）获得页面上与树形对应的<img>标签；

getTextEl（）获得页面上与树形对应的包含文字的<span>标签部分；

hide(）和show（）函数可以控制树形节点是否隐藏；

isChecked（）函数可以判断节点中Checkbox状态；

toggleCheck（）函数可以修改节点中的Checkbox状态；

7、Ext.tree.DefaultSelectionModel
是TreePanel的默认选择模式，该模式一次只能选择树中的一个节点。
主要方法：
clearSelections()：清除对树中所有节点的选择
getSelectedNode()：取得当前被选中的节点
isSelected( TreeNode node )：节点是否被选中
select( TreeNode node )：选中指定节点
unselect( TreeNode node )：取消指定节点的选中状态
selectNext()：选择当前被选节点的下一个节点
selectPrevious()：选择当前被选节点的上一个节点
8、Ext.tree.MultiSelectionModel
是TreePanel的多选择模式，该模式一次可以选择树中的多个节点。
主要方法：
clearSelections()：清除所有节点的选中状态
getSelectedNodes()：取得被选节点组成的数组
isSelected( TreeNode node )：节点是否被选中
select( TreeNode node, [EventObject e], Boolean keepExisting )：选中指定节点
unselect( TreeNode node )：取消指定节点的选中状态
9、Ext.tree.TreeLoader
提供了对子节点的延时加载功能，请求指定的URL地址，返回子节点数据，返回的数据格式如下：
[
{
id: 1,
text: "node1",
leaf: true,
check: false
},
{
id: 2,
text: "node2",
children: [
{
id: 3,
text: "node3",
leaf: true
}
]
}
]
树节点展开时，当前节点的id会作为请求参数被发送到服务器，在服务器可以通过node参数名进行获取。
主要配置项：
dataUrl：获取子节点的URL地址。
baseAttrs：子节点的基本属性对象，该对象中的属性将被添加到树加载器创建的所有子节点上。优先服务器返回的同名属性值。
baseParams：基本的请求参数，这些参数会被附加到每一个节点的请求中
clearOnLoad：在加载前是否移除已存在的子节点，默认为true。
preloadChildren：在第一次加载子节点后是否递归加载所有子节点。
requestMethod：请求方法，可选值有POST、GET。
uiProviders：加载器创建子节点的UI实现类。
url：与dataUrl作用相同。
主要方法：
load( Ext.tree.TreeNode node, Function callback, (Object) scope )：从指定的URL加载树节点。
node：需要加载子节点的树节点。
10、Ext.tree.TreeEditor
主要配置项：
alignment：对齐方式。
editDelay：两次点击节点触发编辑操作的延时时间，默认为350毫秒。
hideEl：在显示编辑器组件时是否隐藏绑定元素。
maxWidth：编辑器的最大宽度，默认为250。
11、Ext.tree.TreeSorter
主要配置项：
property：用于排序的节点属性名，默认为text。
dir：排序方向，可选值有asc、desc，默认为asc。
caseSensitive：是否区分大小写，默认为false。
folderSort：叶节点是否排在非叶节点之下，默认为false。
leafAttr：叶子节点在folder排序时的值，默认为leaf。
sortType：一个自定义函数用于在排序前转换节点值。

12、若要设置选中节点的属性node.setText(‘new node’)，其他属性的设置可以模仿这种方式。

13、 tree.setRootNode( )设置根节点;root.appendChild(node1)表示把node1插到根上面,也就是root添加子 节点node1;root.expand(true,true)其中第一个参数表示是否递归展开子节点，如果为false，就只展开第一级节点，下面的子 节点仍然是折叠状态。第二个参数表示是否要动画效果。

注意：若要出现树形效果，必须要给定一个初始高度，或者定义autoHeight为true。

14、 若要从本地读取json数据，需要写个文本文件为树形提供json数据。需要在TreePanel中设置属性 loader：new Ext.tree.TreeLoader(dataUrl:’03-03.txt’}，还得将根节点的TreeNode改成 AsyncTreeNode，因为TreeNode不支持Ajax，无法生成子节点。若要实现读取本地js中的json数据，也需要设置loader，此 处的url不需要设置，同样TreeNode改成AsyncTreeNode。

注意：在txt文档里应定义节点的属性leaf：true，不然节点会无限循环下去。

15、 若要实现从后台读取数据，需要给根节点设置个id，然后dataUrl将jsp或php文件链上，注意节点的id不能重复。这里不能再使用 root.expand（true）进行递归展开了，不然会导致树形节点不断向后台发送请求，直到所有的节点都展开为止，无法实现异步的效果。

16、icon比iconCls的优先级高，iconCls只能设置背景图片，icon设置的是img中的src部分。

17、若是将tree渲染到某个panel里，不能再用root.expand(true,true)实现根节点展开功能，需要在root中加一个属性expanded：true。

18、TreeNode里的view部分称为UI，包括缩进用的空白，节点之间的连接线，节点展开和折叠的图标以及显示的标题。

19、在弹出框属性中设置animEl：node.ui.textNode实现动态效果，是从节点飞出来的。

20、可以设置节点href属性，以及在新页面打开hrefTarget:’_blank’

21、treepanel事件有click，beforeload，contextmenu右键菜单事件，nodedrop，beforestartedit，complete等。

22、从一棵树拖到另一棵树，需要分别设置enableDrag和enableDrop。

23、 clear( )表示清空过滤条件，这会让树形显示出所有节点；clearBlank：true表示如果查询的字符串是空字符串，就执行 clear（）;autoClear:true表示每次过滤之前先执行clear（），否则会在上次过滤的结果上进行查询；remove表示会删除不符合 过滤条件的节点，这样就不能使用clear（）恢复为过滤之前的状态了。