硕正控件 autoLoad 页面加载时是否自动加载表格数据 默认true,如果自己需要根据页面条件查询数据 建议设置为false 自己去查询加载数据。
硕正表格控件API
属性
属性的定义, 例如:
builder="t1.xml"
url="data.do">
在上面的例子中, 除class为自动初始化控件的标识以外, objid、 builder、 url 都是表格的初始化属性。
下面是所有属性列表:
objid
浏览器将以objid的值为变量名创建一个全局变量指向该表格。
该属性是可选的。
例:
在上面的例子中, 表格的 objid 为 grid , 在表格初始化完成之后, 在js中就可以用 grid 来访问表格了。
builder
builder 是一个字符串, 它指向一个 xml 文件, 这个文件描述了表格的属性和列数据,
例如:
builder="${pageContext.request.contextPath}/xml/scgrid/netbank/test.xml"
对于一个表格来说, builder 和 url 两个属性是必不可少的,
注意创建 xml 文件时, 其存放路径应在 /xml/scgrid/ 下与模块同名的目录中,
关于 xml 的详细配置, 请参考Builder规则
url
url 是一个 action 的地址, 这个 action 接受表格的查询请求, 输出表格所需的数据。
此项也是必填的。
bBar
设置 bBar="default" 显示分页条,
设置 bBar="" 或删除该属性则不显示分页条
height
表格高度, int型, 不要带单位符号。
当 height 属性有值且不为 0 时, autoHeight 属性失效。
autoHeight
autoHeight默认为true,
表格会自动适应页面高度, 并且将页面滚动条隐藏掉, 假如不希望页面滚动条被隐藏, 可设置 noPageScroll="false"
noPageScroll
默认为true,
隐藏body的滚动条, 效果与 $("body").css("overflow", "hidden") 相同
queryForm
一个 jquery 选择器, 指向一个 form, 例如: queryForm="#form1",
绑定了 queryForm 以后, 表格每次刷新(refresh)时都会带上该 form 里的数据提交到服务器端。
假如该 form 中有 type="submit" 的按钮, 则不需要再指定 queryButton。, 则该按钮会自动成为 queryButton。
queryButton
一个 jquery 选择器, 指向一个按钮, 例如: queryButton="#btn1",
这会绑定一个按钮, 点击该按钮会触发表格的 refresh(刷新)动作。
假如queryForm 中存在 type="submit" 的按钮, 则不需要再指定 queryButton。
isRemoteSort
true 或 false, 默认为 true,
是否进行服务器端排序。
checkForm
一个函数, 点击 queryButton 时被调用, 假如返回 false 则会取消表单刷新的动作。
例:
if(xyz){
return false;
}else{
return true;
};
}
builder="t1.xml"
url="data.do"
checkForm="doCheck"
>
autoLoad
页面加载时是否自动加载表格数据, 默认为true
checkbox
是否显示复选框,
可以是 true 或 false 或者一个函数,
如果是一个函数的话, 在函数中返回 true 或 false,
例如:
if(row.xxx){
return false;
}else{
return true;
};
}
builder="t1.xml"
url="data.do"
checkbox="showCheckbox"
>
formatter
formatter 是一个函数, 它在表格每次加载完数据以后被调用,
formatter 对表格性能影响较大, 请尽量不要使用, 可尝试通过在builder.xml中实现相同的效果。
formatter例子:
function gridFormatter(index, row){
// index 为行号, row 为行数据
this.setLink(index, "country");
this.method("SetCellText", index, "shipname", row.shipname + ‘号‘);
}
builder="test.xml"
url="test.do"
formatter="gridFormatter">
allowUserConfig
个性化布局默认是启用的, 也就是说 allowUserConfig="true" 是可以不写的。
假如你希望表格不记忆个性化布局的话, 可以设置: allowUserConfig="false"
个性化布局DEOM:
通过参数allowUserConfig参数启用“个性化记忆布局”功能, 在页面被刷新或者被关闭时, 自动将表格的显示列、列顺序、宽度等信息保存到数据库中, 下次该用户再打开此页面时将看到与上次同样的布局。
用户在其它电脑登录也可看到上次登录的布局。
该参数默认不启用, 如需启用需要在标签中加上:
allowUserConfig="true"
用户如希望还原到原始的布局, 可以点击右键“恢复默认布局”。
HTML代码:
builder="t1.xml"
bbar="default"
allowUserConfig="true"
url="data.do">