Skip to content
/ Grid Public

Responsive table grid to meet various usage scenarios, with: width and height settings, drag and drop sorting, adjustment of column width, editing of cells (check, click, single double-click editing), fixed table header, etc...

Notifications You must be signed in to change notification settings

mizuiren/Grid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

表格主要功能演示

演示链接:http://htmlpreview.github.io/?https://github.com/mizuiren/Grid/blob/master/demo/demo.html

满足各种使用场景的响应式表格组件(Responsive table grid),具备:宽高设置、拖拽排序、调节列宽、编辑单元格(勾选、点选、单双击编辑)、表头固定等...(Responsive table grid to meet various usage scenarios, with: width and height settings, drag and drop sorting, adjustment of column width, editing of cells (check, click, single double-click editing), fixed table header, etc...)

它包含的一些特性有:(Some of the features it contains are:)

  1. 参数数据易配置性,简单的列数据只需要字符串即可。(Parameter data is easy to configure, simple column data only needs character strings.)

  2. 列宽自由化绝对化,不像table的td难以控制(Column width liberalization and absoluteization, unlike table td is difficult to control)

  3. dom结构简易化(Simplified dom structure)

  4. 单元格样式全自定义化,可配置任意属性(Fully customizable cell styles and arbitrary attributes can be configured)

  5. 响应式宽度,宽度变更不需要重新渲染。宽度取决于容器宽度,容器宽度是页面负责。(Responsive width, width change does not require re-rendering. The width depends on the width of the container, which is the responsibility of the page.)

  6. 列数自动根据数据变化(The number of columns automatically changes according to the data)

  7. 拖拽排序表格行(Sort Row By Drag)

  8. flex布局,更加美观紧凑(flex layout, more beautiful and compact)

  9. 丰富的事件监听接口(Rich event monitoring interface)

  10. 大数据分页功能(Big data paging function)

  11. 仿windows系统多选交互(Multi-choice interaction imitating windows system)

  12. 丰富的增删改数据接口(Rich data interface for addition, deletion and modification)

  13. 数据过滤功能(Data filtering function)

声明:支持主流前沿浏览器,不支持IE浏览器!

如何使用?

如渲染一个表格:

let myGrid = new Grid(data, container);
  • data是表格的数据,为一个对象。
  • container为表格的容器,为jq对象。

使用表格的方法:

myGrid.selectRow(5);

或者

container[0].grid.selectRow(5);

myGrid.data/container[0].grid.data绑定了所有渲染表格所要用到的数据,可灵活手动更新

参数设置(data):

  1. header:

    表头数据(每列的配置),数组,数组里面每一项就是对应每一列(对象),

    [
        {
            value:'姓名', 
            id: 'name', 
            width: '20%', //缺省写auto,支持写百分比,注意如果数字和auto混合,所有数字之和不得等于或大于100%宽度,纯数字的话,所有之和应小于等于100%
            sort: true
        },
        {
            value:'年龄', 
            id: 'age', 
            width: '20%', 
            sort: function(a,b) {
                var _a = typeof a === 'object' ? a.value : a;
                var _b = typeof b === 'object' ? b.value : b;
                if(Number(_a) > Number(_b)) {
                    return 1;
                } else if(Number(_b) > Number(_a)) {
                    return -1;
                } else {
                    return 0;
                }
            },
            ellipsis: true
        },
        {
            value:'性别'
        },
    ]
    

    列的配置数据如下:

    • value:该列表头显示的文字
    • id:该列绑定的id,便于dom搜索,如未配置,则默认是列的索引
    • width: 该列的宽度,支持百分比,auto, 和flex布局的css值,如fr,可没有,没有按1fr计算。注:1fr,类似分蛋糕,分剩余空间的多少份
      需要值得注意的是:
      1. auto会被认为fr;
      2. 所有列所设置的宽度(确定的宽度如百分比或具体数值)应小于等于总宽度,未设置宽度的才会有空间生存。
      3. 如总宽度为300px的5列数据:100px 30% 100px 10px, 缺省设置了一列的宽度,那么最后一列的宽度则是0,不会显示。
      4. 注意:如果有勾选框,要给勾选框预留30px
      5. 如果列不需要特殊化,那就等宽设置,都不需要设置width
      6. 如果只是某部分列需要特殊宽度,其它可以用auto代替:auto auto 100px auto auto
    • sort:该列需不需要排序,如果需要把这个设置为true,如果不需要则不要设置,或者false。排序规则默认本地排序。 如果需要自定义排序。可以写排序的方法: sort: function(a,b) {} 参数a,b是每一行该列对应的数据,返回值需要是1或者-1或者0
    • resizeable:该列需不需要调节列宽,true/false
    • ellipsis:该列的内容超出表格宽度需不需要用省略号显示
  2. checkbox:

    • 显示勾选框:checkbox:true
    • 不显示勾选框:checkbox:false或者不配置checkbox
  3. showHeader:

    • 显示表头:showHeader:true
    • 不显示表头:showHeader:false或者不配置showHeader
  4. freezeHeader:

    • 冻格表头:freezeHeader:true, 表头不会随着内容滚动
    • 不冻格表头:freezeHeader:false或者不配置freezeHeader, 表头会随着内容滚动
  5. editable:

    • 打开编辑模式:editable:true, 双击可编辑行
    • 关闭编辑模式:editable:false或者不配置editable, 单双击都不可编辑行或列
  6. editWhenClick:

    • 单击的时候编辑单元格:editWhenClick:true, 前提是editable:true
    • 单击的时候不会编辑单元格:editWhenClick:false或者不配置editWhenClick
  7. selectable:

    • 单击可选择行,勾选可选择行,ctrl+单击可选择行:selectable:true
    • 任何时候都不可以选择行:selectable:false
  8. selectWhenCheck:

    • 勾选复选框的时候选择行selectWhenCheck:true或者不设置selectWhenCheck,默认为true。前提是selectable:true
    • 勾选复选框的时候不可以选择行selectWhenCheck:false
  9. multiSelect:

    • 开启多选:multiSelect:true
    • 关闭多选:multiSelect:false或者不设置multiSelect
  10. border:

    单元格边框,支持三种样式:

    • dotted: 点线
    • dashed:短划线
    • solid:实线
  11. borderColor:

    单元格边框颜色,css颜色值如:

    • #ddd
    • red
    • rbg(200,200,200) ...
  12. rowGap:

    行间距,支持纯数字和任意css单位,纯数字默认为px

  13. columnGap:

    列间距,支持纯数字和任意css单位,纯数字默认为px

  14. width:

    表格的宽度,支持纯数字和任意css单位,以及百分比和auto,纯数字默认为px

  15. rowHeight:

    行高,支持纯数字和任意css单位和auto,不设置默认是auto, 纯数字默认为px

  16. height:

    表格高度,此高度包含表头。支持纯数字和任意css单位

  17. dragable:

    是否可拖拽调整表格行顺序,数据也会进行排序

  18. rows:

    表格的数据,数组,数组的每一项为表格的每一行数据

    1. 数组,数组每一项为每一个单元格数据, 可以为纯数字,对象,任意字符串(包括dom字符串)
    2. 如果是个对象, 对象的键值对应的参数意义:
      {
          value:"白居易",//实际展示到单元格的数据,可以为纯数字,对象,任意字符串(包括dom字符串)
          size:2,//(可选),数字,表示单元格占几格,默认1格,大部分情况无需设置
          style: "background:#ccc;font-size:16px;color:white;",//(可选),单元格样式,可以设置背景,颜色等
          align: "left",//(可选),字符串,单元格对齐方式,'left|center|right',默认是center
          id: "yellowRow",//(可选),单元格识别码。 当type:checkbox是表示行id(便于查找行用于选中), 否则表示列id(便于选择器定位)。
          class:"i18n", //(可选),指定class。
          type:"checkbox", //(可选),必须用在行数据的第一列数据配置,当要指定此单元格是勾选框的时候设置, 相应的一些行属性会绑到该行的勾选框上,如selected、checked、id、disable
          selected:true,//(可选),此行是否需要选上,前提是type:checkbox才有效果
          checked:true,//(可选),此行是否需要勾选,前提是type:checkbox才有效果
          disable:true,//(可选),此行是否需要禁用勾选,前提是type:checkbox才有效果
          editType: {//(可选),此单元格的编辑模式
              type: 'select',目前支持input和select, 默认input
              options: ['a','b','c','d','e'] 如果type是select的话,这是下拉框的选项(数组)
          }
          attributes:{//(可选) 属性对象, 注意系统关键字(class、style)和data-id(id),如果相同会覆盖配置项
              name: 'myCell',
              data-key: 'myKey'
          }
      }
      

    id只有当有通过数据去选中表格行的需求情况下才需要用到,大部分情况下不需要这个。

    样例:
    1. [['5.1','5.2','5.3','5.4', '5.5'],['6.1','6.2','6.3','6.4', '6.5']]

    2. [[{id: 'xxx', type: 'checkbox'},'3.1', '3.2','3.3','3.4', '3.5']]

    3. [[{value: 'aaa', id: 'name',size:2, style:'background:#ccc;font-size:16px;color:white;'},{value: 'aaa', id: 'sex',size:2},'3.3','3.4', '3.5']]

    4. rows可以没有或者为空数组,后续再单独updateData渲染数据:

      let grid = new Grid(data, div);

      grid.updateData(rowsData);

  19. filter:

    • 开启过滤功能:filter:true
    • 关闭过滤功能:filter:false或者不设置filter
  20. pageCount:

    • 分页:number类型,设置是否分页且每页的数目,主要用于针对大数据避免dom过多造成页面卡顿问题
    • 不分页:不设置pageCount
  21. dilatationResize:

    • 是否以扩容式调节列宽,调节列宽的时候容器会扩大并产生滚动条,默认不扩容
    • 扩容:dilatationResize为true
    • 不扩容:dilatationResize为false或者不设置dilatationResize
  22. showPage:

    布尔值,是否显示翻页控制区域

    • 显示: true或者不设置showPage字段
    • 不显示: false
  23. sortByCloud:

    是否使用云端排序

事件监听:

  1. onSelect(rowData, rowNum)

    选中表格行触发

    rowData选中行的数据

    rowNum行号

  2. onClick(rowData, cellData, evt)

    点击单元格触发

    • rowData选中行的数据
    • cellData单元格数据
    • evt事件对象
  3. onUnSelect(rowData, rowNum)

    取消选中表格行触发

    rowData选中行的数据

    rowNum行号

  4. onSelectAll(data)

    全选触发

    data表格的数据

  5. onUnSelectAll(data)

    取消全选触发

    data表格的数据

  6. onBeforeSelect(rowData, evt)

    选中表格行之前触发,可以终止选择,只需要return false,适用与一些定制化表格行不让选择的情景

    • rowData选中行的数据
    • evt事件对象
  7. onCheck(rowData)

    勾选的时候触发

    rowData表格行的数据

  8. onUnCheck(rowData, rowNum)

    取消勾选的时候触发

    rowData表格行的数据

    rowNum行号

  9. ###onCheckAll(rowData) 勾选全部的时候触发

    rowData表格行的数据

  10. onUnCheckAll(rowData)

    取消勾选全部的时候触发

    rowData表格行的数据

  11. onBeforeEdit(rowNum, columnNum, oldValue)

    编辑前触发,可以终止编辑,只需要return false,适用与一些定制化表格行不让编辑的情景

    • rowNum行号
    • columnNum列号
    • oldValue编辑前的旧值
  12. onEndEdit(rowNum, columnNum, oldValue, newValue)

    编辑结束触发

    • rowNum行号
    • columnNum列号
    • oldValue编辑前的旧值
    • newValue编辑后的值
  13. onBeforeEndEdit(rowNum, columnNum, oldValue, newValue)

    编辑结束前触发,常用于编辑结束前的数据校验,返回false将不会结束编辑状态

    • rowNum行号
    • columnNum列号
    • oldValue编辑前的旧值
    • newValue编辑后的值
  14. onContextmenu(rowData, cellData, evt)

    右键的时候触发

    • rowData选中行的数据
    • cellData单元格数据
    • evt事件对象
  15. onDblclick(rowData, cellData, evt)

    双击的时候触发

    • rowData选中行的数据
    • cellData单元格数据
    • evt事件对象
  16. onBeforePageChange(page):

    翻页触发函数,renturn false将不执行系统预设翻页,用户可自定义翻页内容展示

    page: 将要翻的页数

  17. onPageChange(page):

    翻页后触发函数

    page: 目前所处的页数

  18. onSort(sortType):

    执行排序后监听的事件 sortType:

    • 0: 默认排序(初始的顺序)1
    • 1:倒序
    • 2:顺序

方法函数

  1. getData()

    获取表格数据

  2. updateData([[1,2,3,4,5,6,7,8,9]]);

    更新表格数据

  3. getCell(rowNum, columnNum)

    获取单元格的dom元素 rowNum行号,注意是从0开始 columnNum列号,注意是从0开始,勾选框占一列,不显示勾选框的时候不影响其占位号

  4. updateCell($cell, newValue);

    • $cell: 单元格对象
    • newValue: 新的值
  5. selectRow(rowNum, evt, multiSelect);

    • rowNum:行号
    • evt:事件对象,没有的话可传空对象
    • multiSelect:此参数为true则不会清除已经选择的行,反之
  6. selectRowById(id, isMulti);

    • id:id值,指的是渲染数据所绑定的id

    • isMulti: 是否要保留之前的选择

      比如数据:

      1. [[5,5,5,5,5,5], [1,2,3,4,5,{id: 'firstRow',value: 6},7,8,9]]

        myGrid.selectRowById('firstRow');则会选中第二行

      2. [[5,5,5,5,5,5], [{id: 'secondRow',type: 'checkbox'},2,3,4,5,6,7,8,9]]

        myGrid.selectRowById('secondRow', true);则会选中第二行

      注意:一般会用在第二种情况,就是通过隐藏的唯一id(不受编辑影响)进行选中。当然其它非隐藏的也可以,但不太推荐这么做,因为相应值编辑后就会变了,也很难保证唯一性,除非配置不可编辑且唯一,若不是唯一则会选中多行,前提是selectable:true以及multiselect:true

  7. unSelectRowById(id, isMulti);

    根据id取消选中

    跟selectRowById类似

  8. unSelectRow(rowNum);

    取消选择某一行

    rowNum:行号

  9. selectAll()

    选择全部

  10. unSelectAll(filterRows)

    filterRows: 可选,意为排除哪些行,没有则取消全部

    取消除filterRows之外的全部选择

  11. checkAll()

    勾选全部

  12. unCheckAll()

    取消勾选全部

  13. checkOne(rowNum)

    勾选某条数据

    rowNum:行号

  14. unCheckOne(rowNum)

    取消勾选某条数据

    rowNum:行号

  15. endEdit()

    结束并应用编辑

  16. editCell($cell, multiEdit)

    • $cell:单元格jq对象
    • multiEdit:是否需要取消上一个编辑状态, multiEdit为true则不取消,multiEdit为false则取消
  17. getSelectedData()

    获取选中行的数据

  18. getSelectedrowNumbers()

    获取选中的行号

  19. getCheckedData()

    获取勾选行的数据

  20. getColumLength()

    获取列的数据

  21. appendRow(rowData, index)

    新增行数据

    • rowData:行数据,数组
    • index: 插在第几行
  22. deleteRow(rowNum)

    删除行

    rowNum:行数

  23. isRowSelected(rowNum)

    判断某一行有没有选中 rowNum行号

  24. isAllChecked()

    判断是否全部勾选

  25. updateRow(rowData, rowIndex);

    更新行

    • rowData:行新数据
    • rowIndex: 行号
  26. checkRowById(id);

    id:id值,指的是渲染数据所绑定的id

    比如数据:

    1. [[5,5,5,5,5,5], [1,2,3,4,5,{id: 'firstRow',value: 6},7,8,9]]

    myGrid.checkById('firstRow');则会选中第二行

    1. [[5,5,5,5,5,5], [{id: 'secondRow',type: 'checkbox'},2,3,4,5,6,7,8,9]]

    myGrid.checkById('secondRow', true);则会选中第二行

  27. getRowDataById(id);

    通过id获取表格行数据

    id: id值,指的是渲染数据所绑定的id

  28. previousPage:

    后退一页

  29. nextPage:

    前进一页

  30. jumpToPage(page):

    跳到某一页

    page:要跳到的页数

author blog: 秋叶博客https://www.mizuiren.com

About

Responsive table grid to meet various usage scenarios, with: width and height settings, drag and drop sorting, adjustment of column width, editing of cells (check, click, single double-click editing), fixed table header, etc...

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published