（供新手参考）关于gridSelect和treeSelect组件配置说明

xwnabc

X5的大部分形如xxSelect的组件，例如gridSelect 和treeSelect他们的作用都是下拉选择+展示感应

“下拉选择”是指该组件必须有下拉的选项，就是下拉的来源数据源，这里可以是静态的写死的选项，也可以是某一个动态的数据集；

展示感应是指该组件最终会将某一个选项作为展示的内容，并且该内容可以ref到某一个relation，跟任何一个ontology的任一关系进行数据感知。

gridSelect和treeSelect组件唯一的区别是他们的下拉选择是不同的，treeSelect通常需要的下拉选择就是来源数据集必须是树状的数据集。

举例说明：

（1） gridSelect

如果下拉选择的是静态数据源    那么可以直接在gridSelect组件上进行设置 如下图：

上图中有几个属性比较重要：

ref：展示感应的relation

itemset：下拉选择的来源数据源

A 静态数据只需要配置 static-data属性 其他不用配置

如下图：

B 动态数据源 不需要配置static-data属性，其他属性

data-ref：来源的数据集 通常是bizdata的ID

auto-load-data：第一次下拉触发data动态加载，一般设置为true。实质上是指在gridSelect的下拉事件中设置data-ref对应的bizdata的autoload=true

columns：下拉的关系 就是将bizdata中的那些relation作为下拉用到的列  如下图：

ref的列名  就是ontology中的relation的名字。

（2） treeSelect

treeSelect必须选择下拉来源的数据集，这个数据集是tree结构的，如下图：adminAreaData为行政区数据集，设计器如下：

从设计器可以看出，adminAreaData数据集是一个tree状的数据集。而且他是auto-load=true的。通过一个treeSelect组件，我们就可以将这个树状数据集，加载到树形下拉列表中，并且关联到其他的某一个relation进行界面的展示和数据感知。

treeSelect组件的设计器如下图：

通过上面设计器可以看到，ref和label-ref属性可以将最终select选择的选项跟某一个relation进行关联，进行数据感知。重要的属性有：

multi-select：下拉列表是否可以多选  属性为true代表下拉可以多选

delay：延迟加载，这个属性如果为false  则下拉只能选择首层

cascade：级联勾选 这个属性与multi-select是对应的，只有在multi-select为true，就是下拉列表可以多选的时候，cascade属性才是有效的。

itemset：下拉来源的数据集设置，这里跟gridSelect组件是一样的，可以看到auto-load-data我设置的是false，没有对adminAreaData进行自动加载，因为可以从上面adminAreaData本身的设计器看到，这个数据集是autoload=true的，所以这里没必要再次设置。

通过这些设置，前台界面如下图：

希望这个帖子对新手能有帮助，高手也可以补充一些意见，毕竟上面的只是自己用到的属性。

xwnabc

补充一下delay属性 一般设置delay=true
tree,treeGrid,treeSelect,treeFilter上的delay属性指的是分级加载数据的意思，也就是说下一级的数据是通过点击数据行前的+进行刺激加载的（当然这里要配合data使用）
如果设置了delay=false，同时data上又设置了root-filter,那么只能加载root-filter允许范围的数据

lengyu

请问下 1=2是什么意思？

JustepDianz

lengyu 发表于 2012-12-13 15:55
请问下 1=2是什么意思？

grid下拉框组件那个静态数据怎么输入不进去啊？只能添加列，怎么往列里面添加数据？

xwnabc

JustepDianz 发表于 2012-12-13 16:07
grid下拉框组件那个静态数据怎么输入不进去啊？只能添加列，怎么往列里面添加数据？
...

还需要添加行 。

xwnabc

lengyu 发表于 2012-12-13 15:55
请问下 1=2是什么意思？

1=2的意思是先不设置根条件，在必要的时候根据JS代码来设置根条件。

raystar27

很不错啊~~新手很有用，谢谢了

泡泡

我是按照这个配置的，我的仍然显示不了树状，为什么？