dhtmlXTree 中文API

2023-11-20 23:32
文章标签 中文 html api frontend xtree

本文主要是介绍dhtmlXTree 中文API,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

dhtmlXTree是一个功能比较强大的树控件,基本上能满足大部分常规需求,比较好用。
    当然,在使用过程中还是发现一点点问题。下面是我整理的一些里面常用函数的说明(只有简单的说明,如果要看详细的说明,自己查看原函数去):

构造函数
dhtmlXTreeObject(htmlObject, width, height, rootId)//rootId 虚拟根节点,在界面上不会显示,一般取值0

replace IMG tag with background images - solve problem with IE image caching , not works for IE6 SP1
enableIEImageFix(mode)

析构函数
destructor()

实现继承
clone()

节点构造函数
dhtmlXTreeItemObject(itemId,itemText,parentObject,treeObject,actionHandler,mode)// mode - do not show images

从xml字符串加载树
loadXMLString(xmlString,afterCall)//afterCall - function which will be called after xml loading

从xml文件加载树
loadXML(file,afterCall)

新建子节点,前三个参数为必须的
insertNewItem(parentId,itemId,itemText,itemActionHandler,image1,image2,image3,optionStr,childs)
insertNewChild(parentId,itemId,itemText,itemActionHandler,image1,image2,image3,optionStr,childs)

节点展开与收缩:[1-close 2-open]
_HideShow(itemObject,mode)

获取节点状态:0 - 没有子节点, -1 - 节点合拢, 1 - 节点展开
_getOpenState(node)
getOpenState(itemId)

获取选中的节点Id
getSelectedItemId()

选中节点
_selectItem(node,e)

获取节点的index
getIndexById(itemId)

设置鼠标右键点击事件
setOnRightClickHandler(func)

设置鼠标点击事件
setOnClickHandler(func)

设置节点状态改变事件
setOnSelectStateChange(func)

设置允许动态加载xml文件(异步加载)
setXMLAutoLoading(filePath)

设置checkbox点击事件
setOnCheckHandler(func)

设置节点展开/合拢事件
setOnOpenHandler(func)

设置节点开始展/合拢开事件
setOnOpenStartHandler(func)

设置节点展开/合拢结束事件
setOnOpenEndHandler(func)

设置节点双击事件
setOnDblClickHandler(func)

展开节点及下面所有子节点
_xopenAll(node)

//增加了不传递itemId的判断(1494)
openAllItems(itemId)//不传递itemId参数则合拢根节点

根据id获取节点
_globalIdStorageFind(itemId)

合拢节点及其下所有子节点
_xcloseAll(node)

//修改了原来逻辑的一个错误(1521)
closeAllItems(itemId)//不传递itemId参数则合拢根节点

为节点增加用户自定义的数据
//修正一个错误(1548)
setUserData(itemId,name,value)

获取用户自定义的数据
getUserData(itemId,name)

获取节点颜色
getItemColor(itemId)

设置节点颜色
setItemColor(itemId,defaultColor,selectedColor)

获取节点名称--(with HTML formatting, if any)
getItemText(itemId)

获取父节点id
getParentId(itemId)

更改节点id
changeItemId(itemId,newItemId)

标记被剪切的节点
doCut()

粘贴被剪切的节点到新的父节点下
doPaste(itemId)

清空被剪切的节点
clearCut()

移动节点
_moveNode(itemObject,targetObject)

允许三种状态的复选框(全选、不选、部分选中)
enableThreeStateCheckboxes(mode)// 1 - on, 0 - off;

设置鼠标悬浮事件
setOnMouseInHandler(func)

设置鼠标移走事件
setOnMouseOutHandler(func)

设置是否允许显示树图片
enableTreeImages=function(mode)//1 - on, 0 - off

设置是否允许固定模式(对于显示复选框的界面美观一些,但没有水平滚动条)
enableFixedMode(mode)// - 1 - on, 0 - off

是否显示复选框
enableCheckBoxes(mode, hidden)//mode 0/1 hidden 0/1

设置节点图片
setStdImages(image1,image2,image3)//a0 - image for node without childrens a1 - image for closed node a2 - image for opened node

设置是否显示树线
enableTreeLines(mode)

设置图片
setImageArrays(arrayName,image1,image2,image3,image4,image5)//image1 - line crossed image image2 - image with top line image3 - image with bottom line image4 - image without line image5 - single root image

展开当前节点(一节)
_openItem(node)
openItem(itemId)

合拢当前节点(一节)
closeItem(itemId)

获取节点的层节数
getLevel(itemId)

设置节点是否允许被合拢
setItemCloseable(itemId,flag)//flag 0/1

对于展开节点返回子节点数量,对于未加载子节点的节点(异步加载)返回true
hasChildren(itemId)

获取节点下的子节点数
_getLeafCount(itemNode)

设置节点名称
setItemText(itemId,newLabel,newTooltip)

获取节点tip
getItemTooltip(itemId)

刷新节点
refreshItem(itemId)

设置节点图片
setItemImage2(itemId, image1,image2,image3)//image1 - node without childrens image image2 - closed node image image3 - open node image

设置节点图片
setItemImage(itemId,image1,image2)//image1 - node without childrens image or closed node image (if image2 specified)  image2 - open node image (optional)

获取节点下所有子节点id以逗号分割
getSubItems(itemId)
getAllSubItems(itemId)

获取节点的所有子节点
_getAllScraggyItems(node)

获取选中节点的名称--(with HTML formatting, if any)
getSelectedItemText()

设置节点的选中状态
setCheck(itemId,state)//state - checkbox state (0/1/unsure)

设置节点及所有子节点的选中状态
setSubChecked(itemId,state)

获取节点的选中状态 return: node state (0 - unchecked,1 - checked, 2 - third state)
isItemChecked(itemId)

删除节点的所有子节点
deleteChildItems(itemId)

删除节点
deleteItem(itemId,selectParent) //selectParent - If true parent of deleted item get selection, else no selected items leaving in tree.

在节点下创建一个节点,前三个参数是必须的
insertNewNext(itemId,newItemId,itemText,itemActionHandler,image1,image2,image3,optionStr,childs)

根据index获取节点下子节点的id
getChildItemIdByIndex(itemId,index)//itemId 节点id

设置拖动事件
setDragHandler(func)

设置是否允许拖拽
//mode - enabled/disabled [ can be true/false/temporary_disabled - last value mean that tree can be D-n-D can be switched to true later ]
//rmode - enabled/disabled drag and drop on super root
enableDragAndDrop(mode,rmode)

设置是否允许IE缓存
preventIECashing=function(mode)//mode - enable/disable random seed ( disabled by default )

设置是否允许选中节点名称高亮显示
enableHighlighting(mode)//mode - 1 - on, 0 - off

是否允许图片可点击和拖拽(clickable and dragable)
enableActiveImages(mode)// mode - 1 - on, 0 - off

设置节点获得焦点
focusItem(itemId)

获取所有无子节点的节点id
getAllChildless()
getAllLeafs()

获取所有有子节点的节点id
getAllItemsWithKids()

获取所有被选中节点id,不包括第三中状态的节点(部分选中的节点)
getAllChecked()

获取所有被选中节点id,包括第三中状态的节点(部分选中的节点)
getAllCheckedBranches()

获取节点下所有未选中的节点id,不传递itemId表示从根节点开始查找
getAllUnchecked(itemId)

获取所有部分选中的节点id(因部分子节点选中而被选中的节点)
getAllPartiallyChecked()

设置节点样式
setItemStyle(itemId,style_string)

设置是否允许拖拽图片
enableImageDrag(mode)
set function called when tree item draged over another item
setOnDragIn(func)

设置拖拽是是否允许自动滚动
enableDragAndDropScrolling(mode)


补充说明:加载树时,必须确保所有节点的id不重复,否则控件会为重复id自动生成一个随机数(原id+"_"+当前日期)。
增加了一个dhtmlXTreeExtend.js对原类进行扩展,增加了getAllCheckedLeaf(),getAllUcCheckedLeaf()两个函数
修改了1个bug:
1 增加没有选中节点时执行展开/收缩选定节点时报没有parentId的bug
dhtmlXTreeObject.prototype.setSubChecked=function(itemId,state){
   if(itemId)
{
  var sNode=this._globalIdStorageFind(itemId);
  this._setSubChecked(state,sNode);
  this._correctCheckStates(sNode.parentObject);
}
}


1 增加了未传递itemId参数时默认从根节点展开
dhtmlXTreeObject.prototype.openAllItems=function(itemId)
   {
      if (itemId==window.undefined) itemId=this.rootId;
      var temp=this._globalIdStorageFind(itemId);
      if (!temp) return 0;
      this._xopenAll(temp);
   };

这篇关于dhtmlXTree 中文API的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/398251

相关文章

前端高级CSS用法示例详解

《前端高级CSS用法示例详解》在前端开发中,CSS(层叠样式表)不仅是用来控制网页的外观和布局,更是实现复杂交互和动态效果的关键技术之一,随着前端技术的不断发展,CSS的用法也日益丰富和高级,本文将深... 前端高级css用法在前端开发中,CSS(层叠样式表)不仅是用来控制网页的外观和布局,更是实现复杂交

Python将博客内容html导出为Markdown格式

《Python将博客内容html导出为Markdown格式》Python将博客内容html导出为Markdown格式,通过博客url地址抓取文章,分析并提取出文章标题和内容,将内容构建成html,再转... 目录一、为什么要搞?二、准备如何搞?三、说搞咱就搞!抓取文章提取内容构建html转存markdown

在React中引入Tailwind CSS的完整指南

《在React中引入TailwindCSS的完整指南》在现代前端开发中,使用UI库可以显著提高开发效率,TailwindCSS是一个功能类优先的CSS框架,本文将详细介绍如何在Reac... 目录前言一、Tailwind css 简介二、创建 React 项目使用 Create React App 创建项目

vue使用docxtemplater导出word

《vue使用docxtemplater导出word》docxtemplater是一种邮件合并工具,以编程方式使用并处理条件、循环,并且可以扩展以插入任何内容,下面我们来看看如何使用docxtempl... 目录docxtemplatervue使用docxtemplater导出word安装常用语法 封装导出方

基于Flask框架添加多个AI模型的API并进行交互

《基于Flask框架添加多个AI模型的API并进行交互》:本文主要介绍如何基于Flask框架开发AI模型API管理系统,允许用户添加、删除不同AI模型的API密钥,感兴趣的可以了解下... 目录1. 概述2. 后端代码说明2.1 依赖库导入2.2 应用初始化2.3 API 存储字典2.4 路由函数2.5 应

Vue中组件之间传值的六种方式(完整版)

《Vue中组件之间传值的六种方式(完整版)》组件是vue.js最强大的功能之一,而组件实例的作用域是相互独立的,这就意味着不同组件之间的数据无法相互引用,针对不同的使用场景,如何选择行之有效的通信方式... 目录前言方法一、props/$emit1.父组件向子组件传值2.子组件向父组件传值(通过事件形式)方

css中的 vertical-align与line-height作用详解

《css中的vertical-align与line-height作用详解》:本文主要介绍了CSS中的`vertical-align`和`line-height`属性,包括它们的作用、适用元素、属性值、常见使用场景、常见问题及解决方案,详细内容请阅读本文,希望能对你有所帮助... 目录vertical-ali

浅析CSS 中z - index属性的作用及在什么情况下会失效

《浅析CSS中z-index属性的作用及在什么情况下会失效》z-index属性用于控制元素的堆叠顺序,值越大,元素越显示在上层,它需要元素具有定位属性(如relative、absolute、fi... 目录1. z-index 属性的作用2. z-index 失效的情况2.1 元素没有定位属性2.2 元素处

Python实现html转png的完美方案介绍

《Python实现html转png的完美方案介绍》这篇文章主要为大家详细介绍了如何使用Python实现html转png功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 1.增强稳定性与错误处理建议使用三层异常捕获结构:try: with sync_playwright(

Vue 调用摄像头扫描条码功能实现代码

《Vue调用摄像头扫描条码功能实现代码》本文介绍了如何使用Vue.js和jsQR库来实现调用摄像头并扫描条码的功能,通过安装依赖、获取摄像头视频流、解析条码等步骤,实现了从开始扫描到停止扫描的完整流... 目录实现步骤:代码实现1. 安装依赖2. vue 页面代码功能说明注意事项以下是一个基于 Vue.js