TreePanel的各项属性.doc

TreePanel的各项属性1、Ext.tree.TreePanel主要配置项：root：树的根节点。rootVisible：是否显示根节点，默认为true。autoScroll：当内容超过预设的高度时自动出现滚动条。autoHeight: true 自动高度,默认为falsedraggable：是否允许拖曳。enableDrag:true树的节点可以拖动Drag(效果上是),注意不是DraggableenableDD：设置树的节点是否可以拖动。enableDrop:true/仅仅droplines：是否显示树线，默认为true。loader：树节点的加载器，默认为Ext.tree.TreeLoader。selModel：树的选择模式，默认为Ext.tree.DefaultSelectionModel。pathSeparator：树节点路径的分隔符，默认为“/”。singleExpand：是否一次只展开树中的一个节点，默认为true。requestMethod：请求方法，可选值有POST、GET。containerScroll：是否将树形面板注册到滚动管理器ScrollManager中。useArrows：是否在树中使用Vista样式箭头，默认为false。主要方法：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：节点idleaf：当前节点是否为叶子节点主要属性：id：节点idattributes：节点属性的集合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()：取得当前节点的深度，根节点的深度为0getOwnerTree()：取得当前节点所在树。getPath( String attr )：取得当前节点对应的路径，这个路径在程序中可用于展开或者选择节点。attr：用于查找路径的属性，默认为节点idhasChildNodes()：是否有子节点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：是否允许编辑，默认为trueexpanded：是否展开节点，默认为falsedisabled：是否禁用节点，默认为falsesingleClickExpand：是否通过单击方式展开节点allowChildren：是否允许当前节点具有子节点，默认为trueexpandable：当不含子节点时，是否总显示一个加减图标，默认为falseuiProvider：节点的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中获取焦点的元素getIconEl()：获取图标的元素getTextEl()：获取文本节点addClass( String/Array className )：removeClass( String/Array className )：hide()：show()：isChecked()：取得节点的选择状态，如果当前节点没有复选框则函数返回falsetoggleCheck( Boolean (optional) )：设置节点复选框的选择状态6、Ext.tree.TreeNodeUI作为树形节点的视图，我们可以通过node.ui的方式获得某个Ext.tree.TreeNode实例对应的Ext.tree.TreeNodeUI。主要函数：addClass( )给节点增加样式；removeClass（）给节点删除样式；getAnchor（）获得页面上与树形对应的标签；getIconEl（）获得页面上与树形对应的标签；getTextEl（）获得页面上与树形对应的包含文字的标签部分；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不能重复