帆软软件应用程序接口及开发指导文档

FR.ComboBoxEditor

Hierarchy

Subclasses

Files

下拉框控件

var $el = $('<div>').css({position : 'absolute', top : 5, left : 40}).appendTo('body');
var editor = new FR.ComboBoxEditor({
      renderEl : $el,
      directEdit : true,        //是否允许直接编辑
      allowBlank : false,      //是否允许为空
      widgetUrl : null,         //支持模糊搜索,异步取数请求url
      fontSize : 14,             //显示的字体大小
      width : 120,
      height : 24,
      maxCount : 3,            //一页显示的记录数
      sonHeight : 24,           //子项元素高度
      items : [            //本地取数方式,优先于widgetUrl
            {text : "一一", value : "aa"},
            {text : "二二", value : "bb"},
            {text : "三三", value : "cc"},
            {text : "四四", value : "dd"}
     ]
});
Defined By

Config options

允许自定义值 ...

允许自定义值

Defaults to: true

允许直接编辑 ...

允许直接编辑

Defaults to: true

控件的高度 ...

控件的高度

Defaults to: 22

在允许为空的时候待选列表的第一项的值

在允许为空的时候待选列表的第一项的值

FR.ComboBoxEditor
view source
: JSON
属性配置 ...

属性配置

  • maxCount : Number (optional)

    一页显示的记录个数

    Defaults to: 10

  • sonHeight : Number (optional)

    下拉框单项高度

    Defaults to: 18

  • value : Object (optional)

    默认值

    Defaults to: ''

  • limitData : Number (optional)

    单次加载的数据量

    Defaults to: 500

  • autoFixWidth : Boolean (optional)

    自动调整列表宽度

    Defaults to: true

  • allowBlank : Boolean (optional)

    允许为空

    Defaults to: true

  • fontSize : Number

    字体大小

  • widgetUrl : String

    下拉列表数据

  • width : Number

    控件宽度

  • height : Number

    控件高度

  • items : Array

    下拉列表数据,这一项优先于widgetUrl

Overrides: FR.Widget.options

手动输入指定毫秒后开始到服务器去查询符合条件的项 ...

手动输入指定毫秒后开始到服务器去查询符合条件的项

Defaults to: 500

控件的宽度 ...

控件的宽度

Defaults to: 100

Defined By

Properties

正则表达式控件插件接口 正则表达式类型数组

正则表达式控件插件接口 正则表达式类型数组

控件的根节点元素

控件的根节点元素

Defined By

Methods

FR.ComboBoxEditor
view source
( )private
...
( name, widget )private
添加此控件中所包含的空间,以名字/值做对应 * ...

添加此控件中所包含的空间,以名字/值做对应 *

Parameters

  • name : String

    要添加的控件的名字 *

  • widget : FR.Widget

    要添加的控件 *

FR.ComboBoxEditor
view source
( )private
模糊搜索,生成的下拉列表 ...

模糊搜索,生成的下拉列表

FR.ComboBoxEditor
view source
( ) : booleanprivate
...

Returns

  • boolean

Overrides: FR.TriggerEditor._canCancelSearch

FR.ComboBoxEditor
view source
( ) : jQueryprivate
如果允许为空,则生成'不选'一项选择项 ...

如果允许为空,则生成'不选'一项选择项

Returns

  • jQuery

    返回生成的dom对象

FR.ComboBoxEditor
view source
( value )private
检验输入值是否存在于下拉列表中 ...

检验输入值是否存在于下拉列表中

Parameters

  • value : Object
下拉触发按钮样式生成 ...

下拉触发按钮样式生成

生成文本编辑组件 ...

生成文本编辑组件

生成下拉触发按钮组件 ...

生成下拉触发按钮组件

FR.ComboBoxEditor
view source
( needExpand )private
生成下拉列表,并加载数据 ...

生成下拉列表,并加载数据

Parameters

  • needExpand : Object

    是否需要展开下拉列表

FR.ComboBoxEditor
view source
( )private
绑定模糊搜索功能 ...

绑定模糊搜索功能

...

Parameters

  • value : Object
FR.ComboBoxEditor
view source
( )private
...

Returns

  • jQuery

    返回控件DOM的根节点标签 *

FR.ComboBoxEditor
view source
( )private
按键后,模糊搜索前事件,抽象方法 ...

按键后,模糊搜索前事件,抽象方法

文本编辑框失去焦点事件,抽象方法 ...

文本编辑框失去焦点事件,抽象方法

编辑框失焦后,判断是否符合规则等执行事件 ...

编辑框失焦后,判断是否符合规则等执行事件

编辑框获得焦点后事件,抽象方法 ...

编辑框获得焦点后事件,抽象方法

从下拉列表中查找数据 ...

从下拉列表中查找数据

Parameters

  • value : Object

    {String} 要查找的数据

Returns

  • Boolean

    返回是否该数据存在于下拉列表中

获取选中的元素的位置 ...

获取选中的元素的位置

Returns

  • Number

    返回位置编号,如果没有选中元素则返回-1

获取选中的元素 ...

获取选中的元素

Returns

  • *

    返回选中的内容

( records, text, index ) : *private
根据显示值获取实际值 ...

根据显示值获取实际值

Parameters

  • records : Object

    实际值

  • text : Object

    显示值

  • index : Object

    序号

Returns

  • *

    实际值

FR.ComboBoxEditor
view source
( ) : jQueryprivate
获取下拉列表的所有子项 ...

获取下拉列表的所有子项

Returns

Overrides: FR.BaseComboBoxEditor._getViewList

FR.ComboBoxEditor
view source
( )private
初始计算高度宽度相关的尺寸 * ...

初始计算高度宽度相关的尺寸 *

初始化和名字相关的计算 * ...

初始化和名字相关的计算 *

初始化根节点 * ...

初始化根节点 *

初始化下拉列表容器 ...

初始化下拉列表容器

初始化视觉相关效果 * ...

初始化视觉相关效果 *

FR.ComboBoxEditor
view source
( e )private
...

Parameters

  • e : Event

    鼠标事件

不触发下拉按钮事件而选中一个元素 ...

不触发下拉按钮事件而选中一个元素

FR.ComboBoxEditor
view source
( idx, lastidx )private
滚动切换选中的子项元素(仅仅样式改变) ...

滚动切换选中的子项元素(仅仅样式改变)

Parameters

  • idx : Number

    新位置索引

  • lastidx : Number

    旧位置索引

FR.ComboBoxEditor
view source
( records )private
设置下拉框的内容 ...

设置下拉框的内容

Parameters

  • records : Object
滚动选中指定位置的下拉列表子项元素 ...

滚动选中指定位置的下拉列表子项元素

Parameters

  • idx : Number

    位置索引

FR.ComboBoxEditor
view source
( )private
显示下拉列表 ...

显示下拉列表

添加内容 ...

添加内容

FR.ComboBoxEditor
view source
( data )
将数据生成为子项元素,添加到下拉列表中 ...

将数据生成为子项元素,添加到下拉列表中

Parameters

( start, limit ) : Objectprivate
...

Parameters

  • start : Object

    起始数据索引

  • limit : Object

    结束数据索引

Returns

  • Object

    参数

校验并且设置状态标志 ...

校验并且设置状态标志

Parameters

  • cValue : String

    被校验的值

FR.ComboBoxEditor
view source
( data )
判断是否需要滚动加载 ...

判断是否需要滚动加载

Parameters

  • data : Array

    一次加载的数据限制个数

清空文本编辑框 ...

清空文本编辑框

收起下拉列表 ...

收起下拉列表

鼠标下拉框外点击,收起下拉框 ...

鼠标下拉框外点击,收起下拉框

Parameters

  • e : Object

    鼠标事件

返回加入允许为空一项的下拉列表的总元素个数 ...

返回加入允许为空一项的下拉列表的总元素个数

Returns

  • number

    返回个数

控件能否在填报中用做编辑器 * ...

控件能否在填报中用做编辑器 *

Returns

  • Boolean

    可以用做编辑器则返回true,比如FR.ComboBoxEditor;否则返回false

数据联动,生成参数依赖 ...

数据联动,生成参数依赖

Returns

  • Object

    依赖的参数

FR.ComboBoxEditor
view source
( ) : *
添加值 ...

添加值

Returns

  • *
销毁整个控件的dom结构 ...

销毁整个控件的dom结构

...

This method has been deprected

重新设置控件的大小和位置 * ...

重新设置控件的大小和位置 *

Parameters

  • give : Object

Overrides: FR.Widget.doResize

...

Parameters

  • give : Object
FR.ComboBoxEditor
view source
( )private
渲染绘制下拉列表 ...

渲染绘制下拉列表

...

This method has been deprected

FR.ComboBoxEditor
view source
( )
展开下拉列表 ...

展开下拉列表

( eventName ) : Boolean
触发绑定过的事件 * * ...

触发绑定过的事件 * *

Parameters

  • eventName : String

    要触发的事件的名字 *

Returns

  • Boolean

    如果事件函数返回false,则返回false并中断其他同名事件的执行,否则执行所有的同名事件并返回true

FR.ComboBoxEditor
view source
( )private
调整下拉列表宽度(处理兼容问题) ...

调整下拉列表宽度(处理兼容问题)

获取下拉箭头图标的高度 ...

获取下拉箭头图标的高度

Returns

  • number
FR.ComboBoxEditor
view source
( ) : *
取数方法的实现 ...

取数方法的实现

Returns

  • *
数据联动,获取联动数据 ...

数据联动,获取联动数据

Returns

  • Object
获取错误提示内容 ...

获取错误提示内容

Returns

  • String

    返回错误提示内容

获取下拉列表内的元素数 ...

获取下拉列表内的元素数

Returns

  • *
获取控件名字 * ...

获取控件名字 *

Returns

  • Object

    控件名

获取选中的元素 ...

获取选中的元素

Returns

  • Number

    返回位置编号,如果没有选中元素则返回-1

获取控件的显示值,所有表单控件都应该实现这个方法 * ...

获取控件的显示值,所有表单控件都应该实现这个方法 *

Returns

  • String

    获取控件的显示的值

Overrides: FR.Widget.getText

获取控件类型, ...

获取控件类型,

不管是每次取值都从后台读取匹配结果还是从已经加载的数据中匹配,都不是很好 todo 弄成this.value存放控件结果值 ...

不管是每次取值都从后台读取匹配结果还是从已经加载的数据中匹配,都不是很好 todo 弄成this.value存放控件结果值

Returns

  • *

Overrides: FR.Widget.getValue

获取该控件中所添加的子控件 * ...

获取该控件中所添加的子控件 *

Parameters

  • name : String

    要获取的子控件的名字 *

Returns

FR.ComboBoxEditor
view source
( $dom, showValue, index )
初始化一个子项元素 ...

初始化一个子项元素

Parameters

  • $dom : jQuery

    DOM对象

  • showValue : String

    显示值

  • index : Number

    位置索引

初始化数据 ...

初始化数据

Overrides: FR.BaseEditor.initData

...

This method has been deprected

判断控件是否可用 * ...

判断控件是否可用 *

Returns

  • Boolean

    返回true表示可用,返回false表示不可用

下拉列表是否展开 ...

下拉列表是否展开

Returns

  • Boolean

    返回是,则表示展开状态;否则为收起状态

FR.ComboBoxEditor
view source
( ) : Boolean
判断是否正在过滤字段 ...

判断是否正在过滤字段

Returns

  • Boolean

    返回是否正在过滤

"24"这种形式的 * ...

"24"这种形式的 *

Parameters

  • o : Object

    宽度或者高度 *

Returns

  • boolean

    是否是"24"这种形式

判断是否支持数据绑定 ...

判断是否支持数据绑定

Returns

  • Boolean

    支持数据绑定则返回true,否则返回false

校验是否符合规则 ...

校验是否符合规则

Parameters

  • cValue : Object

Returns

  • Boolean

    返回是否符合规则

Overrides: FR.BaseEditor.isValidate

FR.ComboBoxEditor
view source
( value )private
...

Parameters

  • value : Object

Overrides: FR.BaseComboBoxEditor.isValueInList

判断控件是否可见 * ...

判断控件是否可见 *

Returns

  • Boolean

    可见则返回true,不可见则返回false

加载数据 ...

加载数据

修正popup弹出的位置 ...

修正popup弹出的位置

...

Parameters

  • eH : Object
( eventName, fn )
给观察者绑定一个事件 * e.g. ...

给观察者绑定一个事件 * e.g. 给填报页面添加一个提交失败事件:contentPane.on(FR.Events.WF, function() {alert("填报失败!");}); * 给文本框控件p1添加一个初始化后事件:p1.on(FR.Evnets.AFTERINIT, function() {alert("初始化完成!");}); *

Parameters

  • eventName : String

    事件的名字 *

  • fn : Function

    事件对应的执行函数

FR.ComboBoxEditor
view source
( )
点击下拉框右侧小按钮事触发的函数 ...

点击下拉框右侧小按钮事触发的函数

Overrides: FR.TriggerEditor.onTriggerClick

( eventName, fn )
给观察者绑定一个只执行一次的事件 * ...

给观察者绑定一个只执行一次的事件 *

Parameters

  • eventName : String

    事件的名字 *

  • fn : Function

    事件对应的执行函数

清除观察者的所有事件绑定 ...

清除观察者的所有事件绑定

FR.ComboBoxEditor
view source
( items )
重新构建下拉列表 ...

重新构建下拉列表

Parameters

  • items : Object

    列表选项

还原到之前的值 ...

还原到之前的值

恢复控件到初始状态,一般用于重新取值 ...

恢复控件到初始状态,一般用于重新取值

Overrides: FR.Widget.reset

FR.ComboBoxEditor
view source
( )private
滚动加载下拉列表数据 ...

滚动加载下拉列表数据

FR.ComboBoxEditor
view source
( arg )
设置控件的可用性 * ...

设置控件的可用性 *

Parameters

  • arg : Object

Overrides: FR.TriggerEditor.setEnable

FR.ComboBoxEditor
view source
( index )
选中下拉列表中指定位置的一项 ...

选中下拉列表中指定位置的一项

Parameters

  • index : Number

    位置索引

仅支持通过class来设置图标 ...

仅支持通过class来设置图标

Parameters

  • cls : String

    用于展示图标的css样式表类

设置当前被选中的一项 ...

设置当前被选中的一项

Parameters

  • index : Object

    位置索引

设置数据联动源 ...

设置数据联动源

Parameters

  • source : Object

    {JSON} 数据联动源

Overrides: FR.Widget.setSource

设置控件的显示值 * ...

设置控件的显示值 *

Parameters

  • text : Object

Overrides: FR.Widget.setText

设置控件的值 * ...

设置控件的值 *

Parameters

  • value : Object

Overrides: FR.Widget.setValue

FR.ComboBoxEditor
view source
( arg )
设置控件的可见性 * ...

设置控件的可见性 *

Parameters

  • arg : Object

Overrides: FR.Widget.setVisible

需要重新生成下拉列表 ...

需要重新生成下拉列表

开始编辑 ...

开始编辑

结束编辑 ...

结束编辑

保存数据绑定的数据 ...

保存数据绑定的数据

( eventName, fn )
解除观察者绑定的指定事件 * ...

解除观察者绑定的指定事件 *

Parameters

  • eventName : String

    要解除绑定事件的名字 *

  • fn : Function

    事件对应的执行函数,该参数是可选的,没有该参数时,将解除绑定所有同名字的事件

...

This method has been deprected