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

FR.QuickGrid

Hierarchy

FR.OB
FR.Widget
FR.QuickGrid

Files

表格控件

var grid = new FR.QuickGrid({
             renderEl : $('body'),
             baseCls: 'fr-grid',
             marginLeft : 20,
             marginRight :0,
             items : [],
             columnsConfig:[],
             page : true,
             pageCount: 15,
             isFootShow :true,
             isHeadShow :true,
             multiSelect : false,
             intervalColor : false,
             isInitWithData : true,
             async: false,
             onBeforeRowCreate: null,
             onAfterRowCreate: null,
             onBeforeHeadCreate: null,
             onAfterHeadCreate: null,
             onRowClick: null,
             items: [
                         {
                             name: 'Task1',
                             sender: 'peter',
                             deadline: '2014-09-10',
                             status: '0',
                             operation: '1'
                         },
                         {
                             name: 'Task2',
                             sender: 'alex',
                             deadline: '2005-12-10',
                             status: '1',
                             operation: '2'
                         }
                     ],
             columnsConfig: [
                 {
                     key: 'name',
                     value: '任务名称',
                     width: 200
                 },
                 {
                     key: 'sender',
                     value: '发送人',
                     width: 85,
                 },
                {
                     key: 'sendtime',
                     value: '发送时间',
                     width: 120
                 },
                 {
                     key: 'status',
                     value: '任务状态',
                     width: 120
                 },
                 {
                     key: 'operation',
                     value: '任务操作',
                     width: 120
                 },
                 {
                     onCellCreate: function(rowIdx, colIdx, item, colCfg){
                         if(item.operation == '1'){
                             return $('<div/>').html('right');
                         }else{
                             return $('<div/>').html('wrong');
                         }
                     },
                     width: 90
                 },
                 {
                     onCellCreate: function(rowIdx, colIdx, item, colCfg){
                         if(item.status == '1'){
                             return $('<div/>').html('&lsaquo;');
                         }else{
                             return $('<div/>').html('&rsaquo;');
                         }
                     },
                     width: 90
                 }
             ]
     });

Available since: 7.0.6

Defined By

Config options

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

配置属性

  • baseCls : String

    控件基础类

  • baseId : String

    控件唯一ID

  • marginLeft : Number

    左间距

  • marginRight : Number

    右间距

  • items : Array

    数据

  • columnsConfig : Array

    列属性配置

  • localeArray : Array

    需要做国际化转换的列名数组

  • columnsConfig : Function

    [columnIndex].onCellCreate 单元格生成事件

  • columnsConfig : Function

    [columnIndex].onCellClick 单元格点击事件

  • columnsConfig : Function

    [columnIndex].onHeadCellCreate 表头单元格生成事件

  • columnsConfig : Object

    [columnIndex].css 单元格自定义样式

  • page : Boolean (optional)

    是否分页

    Defaults to: false

  • autoPage : Boolean (optional)

    是否自动计算分页

    Defaults to: true

  • pageCount : Number (optional)

    分页后每页显示的数据数,page属性为true时生效

    Defaults to: 15

  • footAlign : String (optional)

    翻页按钮的位置,'bottom'|'top'

    Defaults to: 'bottom'

  • isFootShow : Boolean (optional)

    是否显示表尾控制按钮,page属性为true时生效

    Defaults to: true

  • isHeadShow : Boolean (optional)

    是否显示表头

    Defaults to: true

  • intervalColor : Boolean (optional)

    是否颜色相间

    Defaults to: false

  • multiSelect : Boolean (optional)

    是否多选

    Defaults to: false

  • isInitWithData : Boolean (optional)

    控件生成时是否初始化数据

    Defaults to: true

  • hasHoverCls : Boolean (optional)

    是否有悬浮样式

    Defaults to: true

  • async : Object

    异步属性配置

    • url : String

      异步请求地址

    • type : String

      异步请求方式

    • data : Object

      异步请求参数

  • onPageTurn : Function

    翻页事件

  • onBeforeRowCreate : Function

    行生成前事件

  • onAfterRowCreate : Function

    行生成后事件

  • onBeforeHeadCreate : Function

    表头行生成前事件

  • onAfterHeadCreate : Function

    表头行生成后事件

  • onRowClick : Function

    行点击事件

  • onRowMouseDown : Function

    行鼠标下按事件

  • onRowMouseOver : Function

    行鼠标悬浮事件

  • onRowMouseOut : Function

    行鼠标移出事件

  • onAsyncSuccess : Function

    异步请求成功事件,async属性配置后生效

  • onAsyncError : Function

    异步请求错误事件,async属性配置后生效

Overrides: FR.Widget.options

Defined By

Properties

FR.QuickGrid
view source
: Objectprivate
...

Defaults to: {FIRSTPAGE: 'first', PREVPAGE: 'prev', NEXTPAGE: 'next', LASTPAGE: 'last', JUMPPAGE: 'jump'}

控件的根节点元素

控件的根节点元素

Defined By

Methods

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

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

Parameters

  • name : String

    要添加的控件的名字 *

  • widget : FR.Widget

    要添加的控件 *

FR.QuickGrid
view source
( )private
绑定事件 ...

绑定事件

FR.QuickGrid
view source
( itemcfg )private
...

Parameters

  • itemcfg : Object
FR.QuickGrid
view source
( )private
默认的配置 * ...

默认的配置 *

Overrides: FR.Widget._defaultConfig

...

Returns

  • jQuery

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

FR.QuickGrid
view source
( curDom, targetTag ) : *private
回溯获取指定DOM层对象 ...

回溯获取指定DOM层对象

Parameters

  • curDom : Object

    当前DOM

  • targetTag : String

    DOM节点的标签

Returns

  • *

    返回获取的DOM对象

FR.QuickGrid
view source
( )private
初始化方法 * ...

初始化方法 *

Overrides: FR.Widget._init

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

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

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

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

初始化根节点 * ...

初始化根节点 *

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

初始化视觉相关效果 *

FR.QuickGrid
view source
( )
控件总宽度计算 ...

控件总宽度计算

FR.QuickGrid
view source
( )private
生成表尾的翻页按钮 ...

生成表尾的翻页按钮

FR.QuickGrid
view source
( )private
生成表头 ...

生成表头

FR.QuickGrid
view source
( )private
生成表体 ...

生成表体

FR.QuickGrid
view source
( item )private
API for QuickGrid ...

API for QuickGrid

Parameters

  • item : Object
控件能否在填报中用做编辑器 * ...

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

Returns

  • Boolean

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

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

销毁整个控件的dom结构

...

This method has been deprected

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

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

Parameters

  • give : Object (optional)

    给定的尺寸和位置 *

    • width : Number

      给定的宽度 *

    • height : Number

      给定的高度 *

    • top : Number

      距离其父容器顶部的距离 *

    • left : Number

      距离其父容器左侧的距离

...

This method has been deprected

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

触发绑定过的事件 * *

Parameters

  • eventName : String

    要触发的事件的名字 *

Returns

  • Boolean

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

获取控件名字 * ...

获取控件名字 *

Returns

  • Object

    控件名

multiSelet为true时,可获取选中行的数据 ...

multiSelet为true时,可获取选中行的数据

Returns

  • Array

    返回所有选中的数据

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

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

Returns

  • String

    获取控件的显示的值

获取控件类型, ...

获取控件类型,

FR.QuickGrid
view source
( ) : Object
获取控件的实际值 * ...

获取控件的实际值 *

Returns

  • Object

    获取控件的实际值

Overrides: FR.Widget.getValue

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

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

Parameters

  • name : String

    要获取的子控件的名字 *

Returns

...

This method has been deprected

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

判断控件是否可用 *

Returns

  • Boolean

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

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

"24"这种形式的 *

Parameters

  • o : Object

    宽度或者高度 *

Returns

  • boolean

    是否是"24"这种形式

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

判断控件是否可见 *

Returns

  • Boolean

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

( 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.QuickGrid
view source
( rowIdx, colIdx, item, colCfg ) : *|jQuery|HTMLElement
生成单元格事件 ...

生成单元格事件

Parameters

  • rowIdx : Object

    行索引

  • colIdx : Object

    列索引

  • item : Object

    数据项

  • colCfg : Object

    列属性配置

Returns

FR.QuickGrid
view source
( rowIdx, item ) : *|jQuery|HTMLElement
生成行数据 ...

生成行数据

Parameters

  • rowIdx : Object

    行索引

  • item : Object

    数据项

Returns

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

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

Parameters

  • eventName : String

    事件的名字 *

  • fn : Function

    事件对应的执行函数

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

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

FR.QuickGrid
view source
( )
重新构建数据表格,但不刷新原有数据 ...

重新构建数据表格,但不刷新原有数据

FR.QuickGrid
view source
( items )
刷新数据并重建数据表格 ...

刷新数据并重建数据表格

Parameters

  • items : Array

    需要刷新的静态数据或是异步取数时的其他需要传递的信息

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

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

设置控件的可用性 * ...

设置控件的可用性 *

Parameters

  • enable : Boolean

    如果参数值为true则设置控件为可用,如果参数值为false则设置控件为不可用

设置控件的初始值,一般情况和setValue一样,在初始值为数据绑定的时候需要动态加载数据 * ...

设置控件的初始值,一般情况和setValue一样,在初始值为数据绑定的时候需要动态加载数据 *

Parameters

  • source : Object

    初始值

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

设置控件的显示值 *

Parameters

  • text : String

    要设置的显示值

( value, shouldFireEvent )
设置控件的值 * ...

设置控件的值 *

Parameters

  • value : Object

    要设置的实际值 *

  • shouldFireEvent : Boolean

    是否触发事件

设置控件的可见性 * ...

设置控件的可见性 *

Parameters

  • visible : Boolean

    如果参数值为true则设置控件为可见,如果参数值为false则设置控件为不可见

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

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

Parameters

  • eventName : String

    要解除绑定事件的名字 *

  • fn : Function

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

...

This method has been deprected