jqGrid显示和隐藏列

注意，jqGrid4.0+版本不再将这个模块内置在jqGrid核心js文件里面，单独放到了一个js文件里面，要使用这个功能需要另外导入到页面中，获取更多信息查看升级信息：jqGrid 3.8.x 升级到 4.0.0相关更新

描述

显示一个模态窗口，用户可以选择需要显示和隐藏的列。

插件开发者

Piotr Roznicki

安装

　　要使用格式化特性，需要在下载页面勾选Columns plugin后再下载jqGrid，下载地址：http://www.trirand.com/blog/?page_id=6。开发者可以在src目录中找到 grid.setcolumns.js。

调用方式

一般你可以给button按钮添加点击事件，也可以通过navButtonAdd方法添加导航按钮来调用。

jQuery("#mybutton").click(function() {
   jQuery("#grid_id").setColumns(options);
   return false;
});

示例说明

  • mybutton：button元素的id（也可以为其他有效的html元素，不一定为button） is the id of a button element (can be any other valid HTMl element)
  • grid_id ：已经构造过jqGrid的DOM对象id
  • options：键值对对象，包含下面列出的内容

Show/ hide columns

　　这个方法使用如下的语言文件

$.jgrid = {
//...
	col : {
		caption: "Show/Hide Columns",
		bSubmit: "Submit",
		bCancel: "Cancel"
	},
//...
配置名称 描述 默认值
top 模态对话框top初始化位置。jqModal为false时，相对于jqGrid对象来计算，否则相对当前的视窗（window） 0
left 模态对话框left初始化位置。jqModal为false时，相对于jqGrid对象来计算，否则相对当前的视窗（window） 0
width 模态对话框宽度 200
height 模态对话框高度 auto
dataheight 这个参数控制滚动区域高度，如上图所示的选择列的区域，位于表头和按钮之间 auto
modal 设置对模态话框是否为模态（就是是否显示所谓的遮盖层，lightbox效果）的，仅当启用jqModal插件时才有效（jqModal:true） false
drag 设置对模态话框是否可以拖拽。需要加载 jqDnR 插件和jQuery UI的dragable部件（jQuery widget） true
beforeShowForm

模态对话框显示前触发的事件函数

beforeShowForm : function(formid) {…}

 null
afterShowForm

模态对话框显示后触发的事件函数

afterShowForm: function(formid) {…}

 null
afterSubmitForm 点击提交按钮触发的事件

afterSubmitForm: function(formid) {…}

 null
closeOnEscape 设置为true可以通过按下ESC键关闭对话框窗口 true
ShrinkToFit 设置为true，grid自动调整列宽以便显示所有列 false
jqModal 设置为true将使用jqModal插件创建对话框 false
colnameview 设置为false，将不会显示colModel配置的name值（只显示列标题） true
closeAfterSubmit 设置为false，点击提交按钮后不会关闭对话框 true
onClose 对话框关闭前触发，可以返回true或者false。返回true或者未返回值都会关闭表单对话框，false则不关闭表单对话框。 null
saveicon  数组，定义提交按钮的图标。参数格式说明
  • 第一个参数定义是否显示图标
  • 第二个参数定图标显示位置，在按钮文本左边或者右边（left/right）
  • 第三个参数和主题中定义的有效图标样式一致
 [true,”left”,”ui-icon-disk”]
closeicon 数组，定义取消（关闭）按钮。参数说明参考saveicon配置 [true,”left”,”ui-icon-close”]
updateAfterCheck 设置为ture，当点击对话框中的checkbox时立即显示或者隐藏对应的列。设置为true后会隐藏提交按钮 false
recreateForm 设置为true，对话框每次激活时表单都会从colModel（如果被修改过）中重新创建 false

　　某些不需要显示或者隐藏的列，可以配colModel的hidedlg（默认false），这样这个列就不会出现在模态对话框中可以被用户操作。

来源：http://www.trirand.com/jqgridwiki/doku.php?id=wiki:show_hide_columns

 

加支付宝好友偷能量挖...


原创文章，转载请注明出处：jqGrid显示和隐藏列

评论(1)Web开发网
阅读(5836)喜欢(2)jqGrid中文API