p47502813
/
bee-table
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
bee-table/README.md

310 lines
16 KiB
Markdown
Raw Normal View History

first commit
2016-12-26 16:52:39 +08:00
# bee-table
[![npm version](https://img.shields.io/npm/v/bee-table.svg)](https://www.npmjs.com/package/bee-table)
[![Build Status](https://img.shields.io/travis/tinper-bee/bee-table/master.svg)](https://travis-ci.org/tinper-bee/bee-table)
[![Coverage Status](https://coveralls.io/repos/github/tinper-bee/bee-table/badge.svg?branch=master)](https://coveralls.io/github/tinper-bee/bee-table?branch=master)
删除shallowequal库依赖，update readme
2017-11-16 15:14:38 +08:00
[![dependencies Status](https://david-dm.org/tinper-bee/bee-table/status.svg)](https://david-dm.org/tinper-bee/bee-table)
first commit
2016-12-26 16:52:39 +08:00
[![NPM downloads](http://img.shields.io/npm/dm/bee-table.svg?style=flat)](https://npmjs.org/package/bee-table)
[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/tinper-bee/bee-table.svg)](http://isitmaintained.com/project/tinper-bee/bee-table "Average time to resolve an issue")
[![Percentage of issues still open](http://isitmaintained.com/badge/open/tinper-bee/bee-table.svg)](http://isitmaintained.com/project/tinper-bee/bee-table "Percentage of issues still open")
react bee-table component for tinper-bee
1
2018-09-04 18:28:38 +08:00
该table组件除了基本表格功能之外，还提供了一下功能。
修改readme
2018-09-04 18:21:55 +08:00
* 动态设置过滤列
* 排序合计
* 多选
* 主子表
* 固定表头
* 交互列
* 列拖拽
* 嵌套子表格
* 行、列合并
具体示例代码参考[!这里](http://bee.tinper.org/bee-table/)
## 安装
删除shallowequal库依赖，update readme
2017-11-16 15:14:38 +08:00
[![bee-table](https://nodei.co/npm/bee-table.png)](https://npmjs.org/package/bee-table)
first commit
2016-12-26 16:52:39 +08:00
## 使用方法
```js
fix demo
2017-01-12 08:53:51 +08:00
const columns = [
{ title: '用户名', dataIndex: 'a', key: 'a', width: 100 },
{ id: '123', title: '性别', dataIndex: 'b', key: 'b', width: 100 },
{ title: '年龄', dataIndex: 'c', key: 'c', width: 200 },
{
title: '操作', dataIndex: '', key: 'd', render() {
return <a href="#">一些操作</a>;
},
},
];
const data = [
{ a: '令狐冲', b: '男', c: 41, key: '1' },
{ a: '杨过', b: '男', c: 67, key: '2' },
{ a: '郭靖', b: '男', c: 25, key: '3' },
];
class Demo extends Component {
render () {
return (
<Table
columns={columns}
data={data}
title={currentData => <div>标题: 这是一个标题</div>}
footer={currentData => <div>表尾: 我是小尾巴</div>}
/>
)
}
}
first commit
2016-12-26 16:52:39 +08:00
```
## API
add docs
2017-01-15 12:10:32 +08:00
### Table
update readme
2017-11-16 10:56:52 +08:00
| 参数 | 说明 | 类型 | 默认值 |
| :--------------------- | :--------------------------------------- | :------------------------------------- | :-------------- |
修复在使用selectDisabled参数，点击全选按钮时获取数据不正确bug
2017-12-27 22:21:52 +08:00
| data | 传入的表格数据（key值必需，否则会导致部分功能出现问题。建议使用唯一的值，如id） | array | [] |
feat(Table.js): 新增# bee-table ## API
2017-12-24 22:54:32 +08:00
| bordered | 是否展示外边框和列边框 | boolean | false |
update readme
2017-11-16 10:56:52 +08:00
| columns | 列的配置表，具体配置见下表 | array | - |
| defaultExpandAllRows | 默认是否展开所有行 | bool | false |
| expandedRowKeys | 展开的行，控制属性 | array | - |
| defaultExpandedRowKeys | 初始扩展行键 | array | [] |
| bodyStyle | 添加到tablebody上的style | object | {} |
| style | 添加到table上的style | object | {} |
fix(multiSelect.js): 修复全选功能中使用rowKey参数bug
2018-01-16 17:18:12 +08:00
| rowKey | 如果rowKey是字符串，`record [rowKey]`将被用作键。如果rowKey是function，`rowKey（record, index）`的返回值将被用作键。 | string or Function(record, index):string | 'key' |
update readme
2017-11-16 10:56:52 +08:00
| rowClassName | 获取行的classname | Function(record, index, indent):string | () => '' |
| expandedRowClassName | 获取展开行的className | Function(recode, index, indent):string | () => '' |
| onExpand | 展开行时的钩子函数 | Function(expanded, record) | () => '' |
| onExpandedRowsChange | 函数在扩展行更改时调用 | Function(expandedRows) | () => '' |
| indentSize | indentSize为每个级别的data.i.children，更好地使用column.width指定 | number | 15 |
| onRowClick | 行的点击事件钩子函数 | Function(record, index, event) | () => '' |
| onRowDoubleClick | 行的双击事件钩子函数 | Function(record, index, event) | () => '' |
| expandIconAsCell | 是否将expandIcon作为单元格 | bool | false |
| expandIconColumnIndex | expandIcon的索引，当expandIconAsCell为false时，将插入哪个列 | number | 0 |
| showHeader | 是否显示表头 | bool | true |
| title | 表格标题 | Function | - |
| footer | 表格尾部 | Function | - |
| emptyText | 无数据时显示的内容 | Function | () => 'No Data' |
| scroll | 横向或纵向支持滚动，也可用于指定滚动区域的宽高度：{ x: true, y: 300 } | object | {} |
| rowRef | 获取行的ref | Function(record, index, indent):string | () => null |
| getBodyWrapper | 添加对table body的包装 | Function(body) | body => body |
feat: feat haveExpandIcon to control hidden expandIcon
2018-01-31 19:46:40 +08:00
| expandedRowRender | 额外的展开行 | Function(record, index, indent):node | - |
update readme
2017-11-16 10:56:52 +08:00
| expandIconAsCell | 展开按钮是否单独作为一个单元格 | bool | false |
| expandRowByClick | 设置展开行是否通过点击行触发，此参数需要与上面参数搭配使用（默认是通过点击行前面的加号展开行 | bool | false |
feat(Table.js): 新增footerScroll参数来让表尾和表体公用同一个横向滚动条
2017-12-26 13:27:46 +08:00
| footerScroll | 表尾和body是否公用同一个横向滚动条。（ 如果footer中也是一个table组件，并且也具有滚动条，那么也需要加入footerScroll参数。 ） | bool | false |
feat(Table.js): add loading param fix #10
2018-01-24 15:10:24 +08:00
| loading | 表格是否加载中 | bool|object(详情可以参考上面示例) | false |
feat: feat haveExpandIcon to control hidden expandIcon
2018-01-31 19:46:40 +08:00
| haveExpandIcon | 控制是否显示行展开icon.**注：该参数只有在和expandedRowRender同时使用才生效** | Function(record, index):bool | () =>false |
add:补充过滤文档
2018-09-27 14:22:40 +08:00
| filterable | 是否开启根据条件来过滤数据 | bool | false
| filterDelay | 触发过滤输入的时候的ms延迟时间 | number | 300
feat:过滤行的输入触发条件支持回车、失去焦点触发
2018-10-17 11:20:29 +08:00
| onFilterRowsChange | 触发过滤输入操作以及其他的回调，回车执行函数或者失去焦点触发回调 | (key,val) => () | () => ()
add:补充过滤文档
2018-09-27 14:22:40 +08:00
| onFilterRowsDropChange | 过滤下拉条件的回调 | (key,val)=>() | () => ()
feat(multiSelect.js): 新增selectDisabled可以设置某一行数据无法被全选
2017-12-27 16:23:25 +08:00
修复在使用selectDisabled参数，点击全选按钮时获取数据不正确bug
2017-12-27 22:21:52 +08:00
*注意: data参数中的key值必需，否则会导致部分功能出现问题！建议使用唯一的值，如id*
add docs
2017-01-15 12:10:32 +08:00
### Column
first commit
2016-12-26 16:52:39 +08:00
|参数|说明|类型|默认值|
add docs
2017-01-15 12:10:32 +08:00
|:--|:---|:--|:---|
|key|列的键|string|-|
|className|传入列的classname|String |-|
|colSpan|该列的colSpan|Number|-|
|title|列的标题|node|-|
|dataIndex| 显示数据记录的字段|String|-|
|width|宽度的特定比例根据列的宽度计算|String/Number|-|
|fixed| 当表水平滚动时，此列将被固定：true或'left'或'right'| true/'left'/'right'|-|
|render|cell的render函数有三个参数：这个单元格的文本，这行的记录，这行的索引，它返回一个对象：{children：value，props：{colSpan：1，rowSpan：1}} ==>'children'是这个单元格的文本，props是这个单元格的一些设置|-|
|onCellClick|单击列的单元格时调用|Function(row, event)|-|
补充文档
2018-05-14 11:26:00 +08:00
|onHeadCellClick|单击表头的单元格时调用|Function(row, event)|row 当前行的数据|
add:补充过滤文档
2018-09-27 14:22:40 +08:00
| order | 设置排序 | string（"descend"、"ascend"） | - |
| filterType | 过滤下拉的类型.可选`text`,`dropdown`,`date` | string | text |
| filterDropdown | 是否显示过滤下拉.可选`show`,`hide` | string | show |
add:过滤行功能支持自定义下拉传入数据相关文档.
2018-10-12 10:06:05 +08:00
| format | 针对过滤下拉设置日期类的格式 | string | YYYY-MM-DD |
| filterDropdownAuto | 设置下拉条件是否自动设置选项，`auto`自动根据当前数据生成，`manual`手动传入，可以使用`filterDropdownData`来传入自定义数据 | string | auto |
| filterDropdownData | 下拉条件自定义数据，filterDropdownAuto=manual生效，传入格式：[{ key : "自定义", value : "自定义" }] | array | [] |
add:过滤行的下拉事件触发焦点函数.
2018-10-15 14:59:53 +08:00
| filterDropdownFocus | 触发点击下拉条件的回调，一般用于异步点击请求数据使用 | function | () => () |
补充文档
2018-05-14 11:26:00 +08:00
docs(README.md): 修改expandedRowRender相关使用参数
2017-12-15 13:47:43 +08:00
## 如何引用
需要单独的去引用相应的js文件，目录在lib文件夹，示例如下：
update readme
2017-11-16 10:56:52 +08:00
补充文档
2018-05-14 11:35:03 +08:00
* 在tinper-bee中引用
```js
Update README.md
2018-09-04 18:34:04 +08:00
1
2018-09-04 18:28:38 +08:00
import {Table} from 'tinper-bee'
Update README.md
2018-09-04 18:34:04 +08:00
补充文档
2018-05-14 11:35:03 +08:00
```
* 单独安装bee-table 方式
docs(README.md): 修改expandedRowRender相关使用参数
2017-12-15 13:47:43 +08:00
```js
Update README.md
2018-09-04 18:34:04 +08:00
1
2018-09-04 18:28:38 +08:00
import Table from 'bee-table'
Update README.md
2018-09-04 18:34:04 +08:00
docs(README.md): 修改expandedRowRender相关使用参数
2017-12-15 13:47:43 +08:00
```
update readme
2017-11-16 10:56:52 +08:00
解决multiSelect 重构问题，以及table 表头默认选中问题
2018-11-16 14:46:04 +08:00
## 如何引用增强功能(multiSelect,sort,sum)
补全文档以及示例
2018-05-11 11:30:56 +08:00
补充文档
2018-05-14 11:35:03 +08:00
解决multiSelect 重构问题，以及table 表头默认选中问题
2018-11-16 14:46:04 +08:00
```js
import multiSelect from "bee-table/lib/multiSelect.js";
```
update readme
2017-11-16 10:56:52 +08:00
### multiSelect
全选功能
解决multiSelect 重构问题，以及table 表头默认选中问题
2018-11-16 14:46:04 +08:00
#### data 数据中新增参数
update readme
2017-11-16 10:56:52 +08:00
| 参数 | 说明 | 类型 | 默认值 |
| ------------------- | -------------------------- | -------- | -------- |
解决multiSelect 重构问题，以及table 表头默认选中问题
2018-11-16 14:46:04 +08:00
| _checked | 设置当前数据是否选中 | boolean | true/false |
| _disabled | 禁用当前选中数据 | boolean | true/false
update readme
2017-11-16 10:56:52 +08:00
| getSelectedDataFunc | 返回当前选中的数据数组 | Function | 无 |
### sort
排序功能
#### Column新增参数
| 参数 | 说明 | 类型 | 默认值 |
| ------ | ---------- | -------- | ---- |
| sorter | 排序函数，可以自定义 | Function | 无 |
publish 1.3.1
2018-07-17 16:27:23 +08:00
| sorterClick | 排序钩子函数| Function | (coloum,type) |
doc
2018-07-17 10:23:38 +08:00
update readme
2017-11-16 10:56:52 +08:00
### sum
修改合计文档
2017-12-14 11:02:00 +08:00
合计功能
update readme
2017-11-16 10:56:52 +08:00
#### Column新增参数
| 参数 | 说明 | 类型 | 默认值 |
| ------ | ---------- | -------- | ---- |
| sumCol | 该列设置为合计列，合计行中会显示合计数据 | boolean | false |
补全文档以及示例
2018-05-11 11:30:56 +08:00
### filterColumn
拖拽宽度功能上线
2018-05-13 16:37:41 +08:00
过滤表头列[示例](https://github.com/tinper-bee/bee-table/tree/master/demo/demolist/Demo21.js)
补全文档以及示例
2018-05-11 11:30:56 +08:00
### dragColumn
拖拽列改变宽度
2018-05-13 16:28:08 +08:00
拖拽表头交换顺序[示例](https://github.com/tinper-bee/bee-table/tree/master/demo/demolist/Demo22.js)
补全文档以及示例
2018-05-11 11:30:56 +08:00
#### dragColumn新增参数
| 参数 | 说明 | 类型 | 默认值 |
| ------ | ---------- | -------- | ---- |
| draggable | 当前表格可拖拽 | boolean | false |
doc 修改
2018-07-05 11:10:05 +08:00
| checkMinSize | 当前表格显示最少列数 | boolean | false |
publish 1.2.6
2018-07-04 15:55:48 +08:00
补全文档以及示例
2018-05-11 11:30:56 +08:00
拖拽列改变宽度
2018-05-13 16:28:08 +08:00
update readme
2017-11-16 10:56:52 +08:00
## rendertype
在表格中提供了多种rendertype可以供选择，比如下拉框，输入框，日期等
## 如何引用
需要单独的去引用相应的js文件，目录在render文件夹，示例如下：
```js
import InputRender from "bee-table/render/InputRender.js"
```
## 安装依赖包
不同的render会依赖其他组件，因为此类render组件是作为bee-table的插件机制处理的，默认不会去自动下载所依赖的组件，所以在使用之前需要去安装相应的组件。
### InputRender
输入框类型render
#### 依赖的组件
该render依赖于`bee-icon`,`bee-form-control`,`bee-form`,`bee-tooltip`。
1. 下载依赖。例如：`npm install bee-icon -S`或者`npm install bee-icon --save`
2. 引入css文件。**注：如果引入了CSS的cdn资源，即可忽略此步骤。**例如：`import 'bee-icon/build/Icon.css;'`
#### 配置
| 参数 | 说明 | 类型 | 默认值 |
| ----------------- | ---------------------------------------- | ---------- | ------ |
| name | 该输入框获取数据时的key值，该值不能设置重复且必填 | string | - |
| placeholder | 输入框的提示信息 | string | - |
| value | 输入框中的显示值 | string | 无 |
| isclickTrigger | 是否使用点击触发编辑状态 | boolean | false |
| onChange | 当值发生改变的时候触发的方法 | Function | 无 |
| format | 浏览态格式化类型，Currency:货币数字; | string | 无 |
| formItemClassName | FormItem的class | string | - |
| mesClassName | 校验错误信息的class | string | - |
| isRequire | 是否必填 | bool | false |
| check | 验证的回调函数，参数两个，第一个为校验是否成功`true/false` 第二个为验证结果对象`{name: "", verify: false, value: ""}` | function | - |
| method | 校验方式，change/blur | string | - |
| errorMessage | 错误提示信息 | dom/string | "校验失败" |
| htmlType | 数值类型，目前支持 email/tel/IDCard/chinese/password'类型 | string | - |
| reg | 校验正则，注：设置 htmlType 后 reg 无效 | regExp | - |
### DateRender
日期类型render
#### 依赖的组件
该render依赖于`bee-icon`,`bee-datepicker`,`moment`
1. 下载依赖。例如：`npm install bee-icon -S`或者`npm install bee-icon --save`
2. 引入css文件。**注：如果引入了CSS的cdn资源，即可忽略此步骤。**例如：`import 'bee-icon/build/Icon.css;'`
#### 配置
| 参数 | 说明 | 类型 | 默认值 |
| ----------------- | ---------------------------------------- | ---------- | ------ |
feat(DateRender.js): 新增type参数支持控制日期的不同展现方式，并完善示例和文档
2018-01-08 14:49:47 +08:00
| isclickTrigger | 是否使用点击触发编辑状态 | boolean | false |
| type | 控制日期的显示格式，DatePicker、MonthPicker或者WeekPicker，暂时不支持RangePicker | string | "DatePicker" |
update readme
2017-11-16 10:56:52 +08:00
注:其他参数参见bee-datepicker组件参数配置
### SelectRender
输入框类型render
#### 依赖的组件
该render依赖于`bee-icon`,`bee-select`
1. 下载依赖。例如：`npm install bee-icon -S`或者`npm install bee-icon --save`
2. 引入css文件。**注：如果引入了CSS的cdn资源，即可忽略此步骤。**例如：`import 'bee-icon/build/Icon.css;'`
#### 配置
| 参数 | 说明 | 类型 | 默认值 |
| -------------- | ---------------------------------------- | ------- | ----- |
| isclickTrigger | 是否使用点击触发编辑状态 | boolean | false |
| dataSource | 数据的键值对，在表格浏览态的时候能显示真实的key值。比如[{key:"张三",value:"01"}] | array | - |
注:其他参数参见bee-select组件参数配置
## 开发调试
first commit
2016-12-26 16:52:39 +08:00
```sh
$ git clone https://github.com/tinper-bee/bee-table
$ cd bee-table
$ npm install
$ npm run dev
```
补全文档以及示例
2018-05-11 11:30:56 +08:00