3.几个重要的属性


  XML描述文档中,有几个元素属性比较重要,在此详细说明。
1.Properties\sort: 默认初始排序,例如 sort="country a, city a";

服务器返回的数据是不必预先排序的,因为Load( )后,Treelist会自动按 sort 属性进行再排序!



2.Properties\isTree: Treelist是以列表显示,还是以树显示;
  如果以树显示,通常还需要设定 sort 属性,这样 sort 的列就是树杈;如果有多个列参与排序,例如 sort="country a, city a",就会有多层树杈,这就是所谓“多列多层树”;如果不指定 sort,那么默认第一列为树杈.


3.Properties\Key: 主键(包括复合主键)。如果要使GetChangedXML( )函数成功执行,必须定义主键(level级别为0除外)。并且在调用 GetChangedXML("isValidatKey=true") 提交函数时,Treelist会自动检查,遇到重复键值能自动弹出提示,并将光标跳转到相应单元格


4.Properties\dataURL: 可选的属性,表示数据来源的默认URL;

如果定义了 dataURL 属性,那么 js 中就不需要执行 Load( ) 函数了,因为在Build( )时能自动Load( )!这一点很重要.


通过SetProp( )函数能更改 dataURL,更改成功后,Treelist 能立即自动刷新,相当于重新Load( ).


dataURL 支持表达式(以“=”开头, ).



5.Cols\col\isUnique 和 Cols\col\nullAble: 如果定义了此属性,在 GetChangedXML( ) 函数执行期间,Treelist会自动检查,遇到重复主键能自动弹出提示,并将光标跳转到相应单元格;

隐藏列是不作nullAble、isUnique检查的.



6.Cols \ Col \ displayMask: 显示掩码,语法为"表达式; textColor=表达式; backColor=表达式; leftImage=表达式; rightImage=表达式"。这当中相当于有5个分句,分别表示了文字、文字颜色、背景色、左侧图标、右侧图标的独立表达式,相互之间以分号(;)分隔。
  表达式中可以包含列名(包括其它列的列名),表示引用本行中其它列的内容,并允许用“data”代表本单元格的数据.
  关于表达式的书写规则,在下面的公共内容中有详细说明,也有大量的演示页可供参考()。

<Properties>中也有同名的DisplayMask属性,但<Properties> 的 displayMask 作用域是整个行,且只有 backColor 和 textColor 二种表达式分句.



7.Properties\ref、Background\ref、Fons\ref: 引用外部XML描述文件的相关内容,例如 <Background ref="../Common/thc.xml">,本Background内容将从thc.xml中取得,这样做的好处是很容易统一更改外观.

外部属性将被自动添加到本 XML 中,本 XML 的已有属性不会被替换.


不支持多重嵌套引用.