API
Component

GridSelect ($UI/system/components/justep/gridSelect/gridSelect)

使用范围：UI2

Contents

component GridSelect ($UI/system/components/justep/gridSelect/gridSelect) extends BindComponent

<b>使用场景</b>：下拉选择，提供单选、多选菜单或树形下拉选择; <b>使用方法</b>：添加gridSelect组件，并设置其属性bind-ref和下拉选择数据来源的data;

Constructor Top

  GridSelect ()
  GridSelect ( options)

Attributes Top

boolean autoOptionWidth

下拉部分宽度根据内容自适应，否则使用组件宽度，缺省：false
string bind-extRef

扩展引用
string bind-labelRef

显示名引用
string bind-ref

引用
string class

组件class
boolean clearButton

增加清除数据的按钮
string data

关联的data组件xid
string defaultLabel

空值显示表达式，当空值时，用此表达式计算结果显示
boolean disabled

禁用
string extSeparator

多选ext值分隔符，缺省：,
boolean inputChangeable

允许在直接在input框中输入改变值，和inputFilterable互斥
boolean inputFilterable

允许在直接在input框中输入值过滤选择数据，和inputChangeable互斥
string labelSeparator

多选label值分隔符，缺省：,
boolean multiselect

多选
Options option

下拉部分定义，同Grid组件定义
integer optionHeight

下拉部分最大高度
string selectFilter

选中过滤表达式,此属性需要在创建时给出，组件创建后修改无效

表达式执行的this是行，即$row 当前表达式中可使用变量: "$model" : 当前的model, "$row" : {$UI/system/components/justep/data/data#Row} 当前过滤执行的行

string valueSeparator

多选值分隔符，缺省：,
string xid

组件标示

Methods Top

Object get (String name)
void hideOption ()
void set (json arg)
void showOption ()

Events Top

void onFilterInputChange (FilterInputChange event)
void onHideOption (ViewEvent event)
void onOptionFilter (OptionFilterEvent event)
void onShowOption (ViewEvent event)
void onTreeIconRender (TreeIconRenderEvent event)
void onUpdateValue (ViewEvent event)

Constructor details Top

public GridSelect ()

<b>使用场景</b>：下拉选择，提供单选、多选菜单或树形下拉选择; <b>使用方法</b>：添加gridSelect组件，并设置其属性bind-ref和下拉选择数据来源的data;

public GridSelect ( options)

构造函数

Inherited from ViewComponent

	
		参数options格式类似{parent:xx, config:{}}，parent是组件的父节点，允许为空或不指定，config是组件的参数选项

Parameters

options

参数选项

Attributes Detail Top

public boolean autoOptionWidth

下拉部分宽度根据内容自适应，否则使用组件宽度，缺省：false

public string bind-extRef

扩展引用

public string bind-labelRef

显示名引用

public string bind-ref

引用

public string class

组件class

	
		基础样式: x-gridSelect(必须),
		尺寸样式: x-gridSelect-lg、x-gridSelect-sm

public boolean clearButton

增加清除数据的按钮

public string data

关联的data组件xid

public string defaultLabel

空值显示表达式，当空值时，用此表达式计算结果显示

public boolean disabled

禁用

public string extSeparator

多选ext值分隔符，缺省：,

public boolean inputChangeable

允许在直接在input框中输入改变值，和inputFilterable互斥

public boolean inputFilterable

允许在直接在input框中输入值过滤选择数据，和inputChangeable互斥

public string labelSeparator

多选label值分隔符，缺省：,

public boolean multiselect

多选

public Options option

下拉部分定义，同Grid组件定义

public integer optionHeight

下拉部分最大高度

public string selectFilter

选中过滤表达式,此属性需要在创建时给出，组件创建后修改无效

表达式执行的this是行，即$row 当前表达式中可使用变量: "$model" : 当前的model, "$row" : {$UI/system/components/justep/data/data#Row} 当前过滤执行的行

public string valueSeparator

多选值分隔符，缺省：,

public string xid

组件标示

Methods Detail Top

public Object get (String name)

获取属性值

Parameters

String name

属性名称，取值范围："disabled"

Return Value

Object

public void hideOption ()

隐藏下拉部分

Return Value

void

public void set (json arg)

设置属性值

Parameters

json arg

属性值对
结构如下：

{ "disabled" : {boolean} 禁用， }

Return Value

void

public void showOption ()

显示下拉部分

Return Value

void

Events Detail Top

public void onFilterInputChange (FilterInputChange event)

[回调型事件]inputFilterable为true时，input值改变时触发，在onOptionFilter事件前触发，可用于修改data的filter和数据刷新

Parameters

FilterInputChange event


结构如下：

{ "source" : 组件的js对象, "bindingContext" : 组件绑定的上下文，包含$model、$object等具体请参考bindingContext说明 "inputFilterValue"： input输入的过滤值 }

Return Value

void

public void onHideOption (ViewEvent event)

[回调型事件]值修改事件

Parameters

ViewEvent event


结构如下：

{ "source" : 组件的js对象, "bindingContext" : 组件绑定的上下文，包含$model、$object等具体请参考bindingContext说明 }

Return Value

void

public void onOptionFilter (OptionFilterEvent event)

[回调型事件]下拉数据过滤，可以实现前端排序、过滤等逻辑

Parameters

OptionFilterEvent event


结构如下：

{ "source" : 组件的js对象, "bindingContext" : 组件绑定的上下文，包含$model、$object等具体请参考bindingContext说明 "datas": 数据行数组, "inputFilterValue"： input输入的过滤值 }

Return Value

void

public void onShowOption (ViewEvent event)

[回调型事件]值修改事件

Parameters

ViewEvent event


结构如下：

{ "source" : 组件的js对象, "bindingContext" : 组件绑定的上下文，包含$model、$object等具体请参考bindingContext说明 }

Return Value

void

public void onTreeIconRender (TreeIconRenderEvent event)

[回调型事件]树形图标渲染

Parameters

TreeIconRenderEvent event


结构如下：

{ "source" : 组件的js对象, "bindingContext" : 组件绑定的上下文，包含$model、$object等具体请参考bindingContext说明 "rowID" : 行ID "row" : 行 "html" : 输出显示的html，通过修改html影响展现 }

Return Value

void

public void onUpdateValue (ViewEvent event)

[回调型事件]值修改事件

Parameters

ViewEvent event


结构如下：

{ "source" : 组件的js对象, "bindingContext" : 组件绑定的上下文，包含$model、$object等具体请参考bindingContext说明 }

Return Value

void