demo-widget-ztree/readme.md

# 基于ZTree的下拉树组件

## 控件的特性如下
1. 单选时,选中的节点作为控件值
2. 多选时,选中的节点组成的数组作为控件值
3. 独选时,同一个节点下只有一个值能被选中

三种类型的截图如下

![widget](src/main/resources/com/fr/plugin/widget/ztree/screenshots/styles.png)

## 控件数据设置方式
**注意:**该控件仅支持手动添加层级的方式作为树的数据

1. 树的数据设置支持所有的数据字典类型
2. 下一层中使用参数@1,@2,@3等参数表示该节点上层节点的值
3. 若是要在数据查询中使用层级参数，可以在where条件中写为：where xxx = '${@1}'这种形式

## 使用方式(示例模板见reportlets目录下的ztree.cpt)
1. 安装插件(安装了插件才能打开ztree.cpt,否则打开会报错,如果要查看使用数据查询的实例,查看ztree4db.cpt,所使用的数据结构在tree.sql中)
2. 打开报表参数界面,可以看到多了一个"ZTree的下拉树"控件 
![widget](src/main/resources/com/fr/plugin/widget/ztree/screenshots/widget.png)
3. 将控件拖到参数界面上,选中该控件可以看到该控件的各种属性,如果需要多选树,把模式属性更改为"多选"即可
![widget](src/main/resources/com/fr/plugin/widget/ztree/screenshots/properties.png)
4. 点击"数据"项,可以看到点击数据设置的地方
![widget](src/main/resources/com/fr/plugin/widget/ztree/screenshots/data_set.png)
5. 点击上图圆圈的地方,会弹出树控件的数据设置界面,默认会添加一个层级,选择适合的数据字典类型
![widget](src/main/resources/com/fr/plugin/widget/ztree/screenshots/data_ui.png)
6. 需要添加多层级的时候,点击工具栏上的"添加"图标,如下图示例,添加了4层的树
![widget](src/main/resources/com/fr/plugin/widget/ztree/screenshots/data_result.png)
7. 预览该报表就可以看到下拉树的效果了
![widget](src/main/resources/com/fr/plugin/widget/ztree/screenshots/web_ui.png)