@beisen-phoenix/table/README.md

### API

## Table

| 参数 | 说明 | 类型 | 默认值 | 是否必传 | 备注 |
| --- | --- | :---: | :---: | :---: | --- |
| className | 扩展className | `string` | `phoenix-table` | 否 |  |
| bordered | 是否显示外边框 | `boolean` | false | 否 |  |
| columnHighlight | 单击列，整列高亮效果 | `boolean` | true | 否 |  |
| rowsInView | 单次render的最大行数 | `number` | 0 | 否 | 单次render的最大行数。Table 采用了lazy render的方式来优化在大量数据下的性能，如果你的表格显示的高度超出了20条，可以调整rowsInView的值。为0表示禁用懒加载。 |
| rowKey | 生成每一项key的辅助方法  | `function(obj) 或 string` | true | 0 | 否 | 为 true 时，以数据项本身作为key，相当于 (d => d)；为函数时，使用此函数返回值；为string时，使用这个string对应的数据值。如 'id'，相当于 (d => d.id)。 |
| hover | 是否数据行鼠标悬浮高亮效果 | `boolean` | true | 否 |  |
| size | 尺寸(作用于行高)， 可填值 ['large', 'middle', 'small'] | `string` | 'middle' | 否 |  |
| striped | 是否显示交错斑马底纹 | `string 或 ReactNode` | false | 否 |  |
| useContainerScroll | 是否使用容器的滚动条 | `boolean` | false | 否 | 开启后，头部不会锁定 |
| height | 表格高度 | `number` | - | 否 | 开启后，头部不会锁定 |
| loading | 数据加载中，为true时会展示一个默认的小菊花组件，可以传入一个自定义的Spin代替 | `bool 或 ReactNode` | false | 否 |  |
| loadingView | 自定义的Loaidng组件 | `ReactNode` | false | 否 | 可以通过传递给loadiView一个自定义组件覆盖默认的空视图 |
| emptyView | 空数据效果| `ReactNode` | 无 | 否 | 可以通过传递给emptyView一个自定义组件覆盖默认的空视图 |
| enableWheelScroll | 是否启用touch滚动 | `boolean` | true | 否 | 默认支持滚动条以及touch滚动，可禁用touch滚动 |
| columns | 数组，见Column | `Column[]` | - | 是 |  |
| columnResizable | 列宽是否可拖拽宽度，默认为true，如果想禁用某列拖拽宽度，可以给单独列设置columnResizable | `boolean` | true | 否 |  |
| columnDefaultWidth | 默认列宽的宽度，仅在未设置列宽的场景下生效。默认为140，如果认为140过大，可以自定义设置，但是为了体验，建议不小于56. | `boolean` | 140 | 否 | 强烈建议此值设置不小于56 |
| sorter | 表格统一排序函数，参数分别为 Column.sorter 和 排序方式 | `func` | 无 | 否 | 强烈建议此值设置不小于56 |
| fit | 是否启用列宽自适应 | `boolean` | true | 否 | 当为true，会自适应宽度; 为false,会可以单独设置宽度，并且不随浏览器窗口大小改变调整  |
| ellipsis | 内容超过单元格宽度是否显示...,默认为false，也就是会换行 | `boolean` | false | 否 | 强烈建议不要设置为true，会导致性能问题(数据量过大) |
| fixed | 滚动条显示设置，可填值 ['both', 'x', 'y'] | `string` | 'both' | 否 | 如果确定不会出现x轴滚动条，可以设置为 y,其他情况类似，无特殊需求，不建议调整 |
| expandKeys | 展开的行的key数组 | `array` | [] | 否 |  |
| expandedRowRender | 展开的行内容 | `function` | 无 | 否 | 如果是可展开，此项是必填 |
| dataSource | 数据源 | `object[]` | 无 | 是 |  |
| pagination | 分页配置，参考下面pagination | `object` | pagination: { current: 1, pageSize: 15, }, | 是 |  |
| settingPanel | 表格设置，参考下面settingPanel | `object` | pagination: { current: 1, pageSize: 15, }, | 是 |  |
| rowSelection | 表格选中设置，参考下面rowSelection | `object` | {} | 否 |  |

## pagination

| 参数 | 说明 | 类型 | 默认值 | 是否必传 | 备注 |
| --- | --- | :---: | :---: | :---: | --- |
| current | 当前页数 | `number` | 1 | 是 |  |
| total | 总数 | `number` | - | 是 |  |
| pageSize | 每页显示条数 | `number` | 15 | 是 |  |
| capacityOptions | 显示条数配置 | `number[]` | [15, 30, 60, 100] | 否 |  |
| showSelectCount | 底部是否显示'已选中N条'文本 | `boolean` | true | 否 |  |
| showSelectAllPageCheckbox | 底部是否显示跨页全选 | `boolean` | false | 否 |  |
| selectAllPageCheckbox | 底部跨页全选是否选中 | `boolean` | false | 否 |  |
| onChange | 当前页数、每页显示条数发生变化回调时间 | `function` | - | 否 |  |

* 其他参考pagination组件

## rowSelection

| 参数 | 说明 | 类型 | 默认值 | 是否必传 | 备注 |
| --- | --- | :---: | :---: | :---: | --- |
| type | 多选或者单选, 可选值 'multiple', 'single' | `string` | 无 | 是 |  |
| disabledAllCheckbox | 禁用头部全选复选框 | `boolean` | - | 否 |  |
| selectedRowKeys | 默认选中项，根据rowKey进行匹配 | `string[]` | [] | 是 |  |
| onChange | 选中项发生变化回调时间 | `function` | 无 | 否 |  |


## columns

| 参数 | 说明 | 类型 | 默认值 | 是否必传 | 备注 |
| --- | --- | :---: | :---: | :---: | --- |
| align | 单元格内容排布方式，可选 ['left', 'center', 'right'] | `string` | 'left' | 否 |  |
| fixed | 锁定列，可选['left', 'right']， | `string` | - | 否 | 如果相邻的多列需要锁定，只需指定最外侧的column即可 |
| key | 列的key，默认使用index | `string | number` | - | 否 |  |
| render | 表格内容生成函数； | `function` | 无 | 否 | d: 当前行数据i: 当前行索引为了使用方便，可以传入一个数据的key，如 'id'，相当于 (d) => { return d.id }  |
| dataIndex | 列数据在数据项中对应的 key | `string` | - | 是 |  |
| title | 列头显示文字 | `string | ReactNode` | - | 否 |  |
| width | 列宽 | `number` | 140 | 否 |  |