1.0.3 • Published 4 years ago

qylc-antd v1.0.3

Weekly downloads
5
License
MIT
Repository
github
Last release
4 years ago

🏆 Use Ant Design Table like a Pro!

Demo

API

pro-table 在 antd 的 table 上进行了一层封装,支持了一些预设,并且封装了一些行为。这里只列出与 antd table 不同的 api。

Table

属性描述类型默认值
request一个获得 dataSource 的方法(params?: {pageSize: number;current: number;[key: string]: any;}) => Promise<RequestData<T>>-
postData对通过 url 获取的数据进行一些处理(data: T[]) => T[]-
defaultData默认的数据T[]-
actionRefget table actionReact.MutableRefObject<ActionType> \| ((actionRef: ActionType) => void)-
toolBarRender渲染工具栏,支持返回一个 dom 数组,会自动增加 margin-right(action: UseFetchDataAction<RequestData<T>>) => React.ReactNode[]-
onLoad数据加载完成后触发,会多次触发(dataSource: T[]) => void-
onRequestError数据加载失败时触发(e: Error) => void-
tableClassName封装的 table 的 classNamestring-
tableStyle封装的 table 的 styleCSSProperties-
optionstable 的默认操作,设置为 false 可以关闭它{{ fullScreen: boolean \| function, reload: boolean \| function,setting: true }}{ fullScreen: true, reload:true , setting: true }
search是否显示搜索表单,传入对象时为搜索表单的配置boolean \| { span?: number \| DefaultColConfig,searchText?: string, resetText?: string, collapseRender?: (collapsed: boolean) => React.ReactNode, collapsed:boolean, onCollapse: (collapsed:boolean)=> void }true
dateFormattermoment 的格式化方式"string" \| "number" \| falsestring
beforeSearchSubmit搜索之前进行一些修改(params:T)=>T-
onSizeChangetable 尺寸发生改变(size: 'default' | 'middle' | 'small' | undefined) => void-
columnsStateMapcolumns 的状态枚举{[key: string]: { show:boolean, fixed: "right"|"left"} }-
onColumnsStateChangecolumns 状态发生改变(props: {[key: string]: { show:boolean, fixed: "right"|"left"} }) => void-`
formsearch From 配置 type="form" 和 搜索表单 的 Form 配置 基本配置与 antd Form 相同 但是劫持了 form 的配置,可用来初始化 formDataOmit<FormProps, 'form'>-

Columns

属性描述类型默认值
renderText类似 table 的 render,但是必须返回 string,如果只是希望转化枚举,可以使用 valueEnum(text: any,record: T,index: number,action: UseFetchDataAction<RequestData<T>>) => string-
render类似 table 的 render,第一个参数变成了 dom,增加了第四个参数 action(text: React.ReactNode,record: T,index: number,action: UseFetchDataAction<RequestData<T>>) => React.ReactNode \| React.ReactNode[]-
renderFormItem渲染查询表单的输入组件(item,props:{value,onChange}) => React.ReactNode-
ellipsis是否自动缩略boolean-
copyable是否支持复制boolean-
valueEnum值的枚举,会自动转化把值当成 key 来取出要显示的内容valueEnum-
valueType值的类型 见后面的详细说明
hideInSearch在查询表单中不展示此项boolean-
hideInTable在 Table 中不展示此列boolean-
formItemProps查询表单的 props,会透传给表单项{ [prop: string]: any }-

ActionType

有些时候我们要触发 table 的 reload 等操作,action 可以帮助我们做到这一点。

interface ActionType {
  reload: () => void;
  fetchMore: () => void;
  reset: () => void;
}

const ref = useRef<ActionType>();

<ProTable actionRef={ref} />;

// 刷新
ref.reload();

// 加载更多
ref.fetchMore();

// 重置到默认值
ref.reset();

// 清空选中项
ref.clearSelected();

valueType

类型描述示例
money转化值为金额¥10,000.26
date日期2019-11-16
dateTime日期和时间2019-11-16 12:50:00
time时间12:50:00
option操作项,会自动增加 marginRight,只支持一个数组,表单中会自动忽略[<a>操作a</a>,<a>操作b</a>]
text默认值,不做任何处理-
textarea与 text 相同, form 转化时会转为 textarea 组件-
index序号列-
indexBorder带 border 的序号列-
progress进度条-
digit单纯的数字,form 转化时会转为 inputNumber-
progress进度条-
boolean是否-
image图片-

valueEnum

当前列值的枚举

interface IValueEnum {
  [key: string]:
    | React.ReactNode
    | {
        text: React.ReactNode;
        status: 'Success' | 'Error' | 'Processing' | 'Warning' | 'Default';
      };
}

Usage

npm install @ant-design/pro-table
# or
yarn add @ant-design/pro-table
import React, { useState } from 'react';
import ProTable, { ProColumns } from '@ant-design/pro-table';
import { Input, Button } from 'antd';

const columns: ProColumns[] = [
  {
    title: 'Name',
    dataIndex: 'name',
    copyable: true,
  },
  {
    title: 'Age',
    dataIndex: 'age',
  },
  {
    title: 'date',
    dataIndex: 'date',
    valueType: 'date',
  },
  {
    title: 'option',
    valueType: 'option',
    dataIndex: 'id',
    render: (text, row, index, action) => [
      <a
        onClick={() => {
          window.alert('确认删除?');
          action.reload();
        }}
      >
        delete
      </a>,
      <a
        onClick={() => {
          window.alert('确认刷新?');
          action.reload();
        }}
      >
        reload
      </a>,
    ],
  },
];

export default () => {
  const [keywords, setKeywords] = useState('');
  return (
    <ProTable<{}, { keywords: string }>
      size="small"
      columns={columns}
      request={() => ({
        data: [
          {
            name: 'Jack',
            age: 12,
            date: '2020-01-02',
          },
        ],
        success: true,
      })}
      rowKey="name"
      params={{ keywords }}
      toolBarRender={action => [
        <Input.Search
          style={{
            width: 200,
          }}
          onSearch={value => setKeywords(value)}
        />,
      ]}
      pagination={{
        defaultCurrent: 10,
      }}
    />
  );
};

LICENSE

MIT npm config set registry https://registry.npm.taobao.org

发布命令

npm config set registry https://registry.npmjs.org npm publish