import * as React from 'react'; import classNames from 'classnames'; import { INTERNAL_HOOKS } from 'rc-table'; import type { Reference as RcReference, TableProps as RcTableProps } from 'rc-table'; import { convertChildrenToColumns } from 'rc-table/lib/hooks/useColumns'; import omit from 'rc-util/lib/omit'; import useProxyImperativeHandle from '../_util/hooks/useProxyImperativeHandle'; import type { Breakpoint } from '../_util/responsiveObserver'; import scrollTo from '../_util/scrollTo'; import type { AnyObject } from '../_util/type'; import { devUseWarning } from '../_util/warning'; import type { ConfigConsumerProps } from '../config-provider/context'; import { ConfigContext } from '../config-provider/context'; import DefaultRenderEmpty from '../config-provider/defaultRenderEmpty'; import useCSSVarCls from '../config-provider/hooks/useCSSVarCls'; import useSize from '../config-provider/hooks/useSize'; import type { SizeType } from '../config-provider/SizeContext'; import useBreakpoint from '../grid/hooks/useBreakpoint'; import defaultLocale from '../locale/en_US'; import Pagination from '../pagination'; import type { SpinProps } from '../spin'; import Spin from '../spin'; import { useToken } from '../theme/internal'; import renderExpandIcon from './ExpandIcon'; import useContainerWidth from './hooks/useContainerWidth'; import type { FilterConfig, FilterState } from './hooks/useFilter'; import useFilter, { getFilterData } from './hooks/useFilter'; import useLazyKVMap from './hooks/useLazyKVMap'; import usePagination, { DEFAULT_PAGE_SIZE, getPaginationParam } from './hooks/usePagination'; import useSelection from './hooks/useSelection'; import type { SortState } from './hooks/useSorter'; import useSorter, { getSortData } from './hooks/useSorter'; import useTitleColumns from './hooks/useTitleColumns'; import type { ColumnsType, ColumnTitleProps, ColumnType, ExpandableConfig, ExpandType, FilterValue, GetPopupContainer, GetRowKey, RefInternalTable, SorterResult, SorterTooltipProps, SortOrder, TableAction, TableCurrentDataSource, TableLocale, TablePaginationConfig, TableRowSelection, } from './interface'; import RcTable from './RcTable'; import RcVirtualTable from './RcTable/VirtualTable'; import useStyle from './style'; export type { ColumnsType, TablePaginationConfig }; const EMPTY_LIST: AnyObject[] = []; interface ChangeEventInfo { pagination: { current?: number; pageSize?: number; total?: number; }; filters: Record; sorter: SorterResult | SorterResult[]; filterStates: FilterState[]; sorterStates: SortState[]; resetPagination: (current?: number, pageSize?: number) => void; } export interface TableProps extends Omit< RcTableProps, | 'transformColumns' | 'internalHooks' | 'internalRefs' | 'data' | 'columns' | 'scroll' | 'emptyText' > { dropdownPrefixCls?: string; dataSource?: RcTableProps['data']; columns?: ColumnsType; pagination?: false | TablePaginationConfig; loading?: boolean | SpinProps; size?: SizeType; bordered?: boolean; locale?: TableLocale; rootClassName?: string; onChange?: ( pagination: TablePaginationConfig, filters: Record, sorter: SorterResult | SorterResult[], extra: TableCurrentDataSource, ) => void; rowSelection?: TableRowSelection; getPopupContainer?: GetPopupContainer; scroll?: RcTableProps['scroll'] & { scrollToFirstRowOnChange?: boolean; }; sortDirections?: SortOrder[]; showSorterTooltip?: boolean | SorterTooltipProps; virtual?: boolean; } /** Same as `TableProps` but we need record parent render times */ export interface InternalTableProps extends TableProps { _renderTimes: number; } const InternalTable = ( props: InternalTableProps, ref: React.MutableRefObject, ) => { const { prefixCls: customizePrefixCls, className, rootClassName, style, size: customizeSize, bordered, dropdownPrefixCls: customizeDropdownPrefixCls, dataSource, pagination, rowSelection, rowKey = 'key', rowClassName, columns, children, childrenColumnName: legacyChildrenColumnName, onChange, getPopupContainer, loading, expandIcon, expandable, expandedRowRender, expandIconColumnIndex, indentSize, scroll, sortDirections, locale, showSorterTooltip = { target: 'full-header' }, virtual, } = props; const warning = devUseWarning('Table'); if (process.env.NODE_ENV !== 'production') { warning( !(typeof rowKey === 'function' && rowKey.length > 1), 'usage', '`index` parameter of `rowKey` function is deprecated. There is no guarantee that it will work as expected.', ); } const baseColumns = React.useMemo( () => columns || (convertChildrenToColumns(children) as ColumnsType), [columns, children], ); const needResponsive = React.useMemo( () => baseColumns.some((col: ColumnType) => col.responsive), [baseColumns], ); const screens = useBreakpoint(needResponsive); const mergedColumns = React.useMemo(() => { const matched = new Set(Object.keys(screens).filter((m) => screens[m as Breakpoint])); return baseColumns.filter((c) => !c.responsive || c.responsive.some((r) => matched.has(r))); }, [baseColumns, screens]); const tableProps: TableProps = omit(props, ['className', 'style', 'columns']); const { locale: contextLocale = defaultLocale, direction, table, renderEmpty, getPrefixCls, getPopupContainer: getContextPopupContainer, } = React.useContext(ConfigContext); const mergedSize = useSize(customizeSize); const tableLocale: TableLocale = { ...contextLocale.Table, ...locale }; const rawData: readonly RecordType[] = dataSource || EMPTY_LIST; const prefixCls = getPrefixCls('table', customizePrefixCls); const dropdownPrefixCls = getPrefixCls('dropdown', customizeDropdownPrefixCls); const [, token] = useToken(); const rootCls = useCSSVarCls(prefixCls); const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls, rootCls); const mergedExpandable: ExpandableConfig = { childrenColumnName: legacyChildrenColumnName, expandIconColumnIndex, ...expandable, expandIcon: expandable?.expandIcon ?? table?.expandable?.expandIcon, }; const { childrenColumnName = 'children' } = mergedExpandable; const expandType = React.useMemo(() => { if (rawData.some((item) => item?.[childrenColumnName])) { return 'nest'; } if (expandedRowRender || expandable?.expandedRowRender) { return 'row'; } return null; }, [rawData]); const internalRefs: NonNullable = { body: React.useRef(), } as NonNullable; // ============================ Width ============================= const getContainerWidth = useContainerWidth(prefixCls); // ============================= Refs ============================= const rootRef = React.useRef(null); const tblRef = React.useRef(null); useProxyImperativeHandle(ref, () => ({ ...tblRef.current!, nativeElement: rootRef.current!, })); // ============================ RowKey ============================ const getRowKey = React.useMemo>(() => { if (typeof rowKey === 'function') { return rowKey; } return (record: RecordType) => record?.[rowKey as string]; }, [rowKey]); const [getRecordByKey] = useLazyKVMap(rawData, childrenColumnName, getRowKey); // ============================ Events ============================= const changeEventInfo: Partial> = {}; const triggerOnChange = ( info: Partial>, action: TableAction, reset = false, ) => { const changeInfo = { ...changeEventInfo, ...info, }; if (reset) { changeEventInfo.resetPagination?.(); // Reset event param if (changeInfo.pagination?.current) { changeInfo.pagination.current = 1; } // Trigger pagination events if (pagination) { pagination.onChange?.(1, changeInfo.pagination?.pageSize!); } } if (scroll && scroll.scrollToFirstRowOnChange !== false && internalRefs.body.current) { scrollTo(0, { getContainer: () => internalRefs.body.current!, }); } onChange?.(changeInfo.pagination!, changeInfo.filters!, changeInfo.sorter!, { currentDataSource: getFilterData( getSortData(rawData, changeInfo.sorterStates!, childrenColumnName), changeInfo.filterStates!, childrenColumnName, ), action, }); }; /** * Controlled state in `columns` is not a good idea that makes too many code (1000+ line?) to read * state out and then put it back to title render. Move these code into `hooks` but still too * complex. We should provides Table props like `sorter` & `filter` to handle control in next big * version. */ // ============================ Sorter ============================= const onSorterChange = ( sorter: SorterResult | SorterResult[], sorterStates: SortState[], ) => { triggerOnChange( { sorter, sorterStates, }, 'sort', false, ); }; const [transformSorterColumns, sortStates, sorterTitleProps, getSorters] = useSorter({ prefixCls, mergedColumns, onSorterChange, sortDirections: sortDirections || ['ascend', 'descend'], tableLocale, showSorterTooltip, }); const sortedData = React.useMemo( () => getSortData(rawData, sortStates, childrenColumnName), [rawData, sortStates], ); changeEventInfo.sorter = getSorters(); changeEventInfo.sorterStates = sortStates; // ============================ Filter ============================ const onFilterChange: FilterConfig['onFilterChange'] = (filters, filterStates) => { triggerOnChange({ filters, filterStates }, 'filter', true); }; const [transformFilterColumns, filterStates, filters] = useFilter({ prefixCls, locale: tableLocale, dropdownPrefixCls, mergedColumns, onFilterChange, getPopupContainer: getPopupContainer || getContextPopupContainer, rootClassName: classNames(rootClassName, rootCls), }); const mergedData = getFilterData(sortedData, filterStates, childrenColumnName); changeEventInfo.filters = filters; changeEventInfo.filterStates = filterStates; // ============================ Column ============================ const columnTitleProps = React.useMemo>(() => { const mergedFilters: Record = {}; Object.keys(filters).forEach((filterKey) => { if (filters[filterKey] !== null) { mergedFilters[filterKey] = filters[filterKey]!; } }); return { ...sorterTitleProps, filters: mergedFilters, }; }, [sorterTitleProps, filters]); const [transformTitleColumns] = useTitleColumns(columnTitleProps); // ========================== Pagination ========================== const onPaginationChange = (current: number, pageSize: number) => { triggerOnChange( { pagination: { ...changeEventInfo.pagination, current, pageSize }, }, 'paginate', ); }; const [mergedPagination, resetPagination] = usePagination( mergedData.length, onPaginationChange, pagination, ); changeEventInfo.pagination = pagination === false ? {} : getPaginationParam(mergedPagination, pagination); changeEventInfo.resetPagination = resetPagination; // ============================= Data ============================= const pageData = React.useMemo(() => { if (pagination === false || !mergedPagination.pageSize) { return mergedData; } const { current = 1, total, pageSize = DEFAULT_PAGE_SIZE } = mergedPagination; warning(current > 0, 'usage', '`current` should be positive number.'); // Dynamic table data if (mergedData.length < total!) { if (mergedData.length > pageSize) { warning( false, 'usage', '`dataSource` length is less than `pagination.total` but large than `pagination.pageSize`. Please make sure your config correct data with async mode.', ); return mergedData.slice((current - 1) * pageSize, current * pageSize); } return mergedData; } return mergedData.slice((current - 1) * pageSize, current * pageSize); }, [ !!pagination, mergedData, mergedPagination?.current, mergedPagination?.pageSize, mergedPagination?.total, ]); // ========================== Selections ========================== const [transformSelectionColumns, selectedKeySet] = useSelection( { prefixCls, data: mergedData, pageData, getRowKey, getRecordByKey, expandType, childrenColumnName, locale: tableLocale, getPopupContainer: getPopupContainer || getContextPopupContainer, }, rowSelection, ); const internalRowClassName = (record: RecordType, index: number, indent: number) => { let mergedRowClassName: string; if (typeof rowClassName === 'function') { mergedRowClassName = classNames(rowClassName(record, index, indent)); } else { mergedRowClassName = classNames(rowClassName); } return classNames( { [`${prefixCls}-row-selected`]: selectedKeySet.has(getRowKey(record, index)), }, mergedRowClassName, ); }; // ========================== Expandable ========================== // Pass origin render status into `rc-table`, this can be removed when refactor with `rc-table` (mergedExpandable as any).__PARENT_RENDER_ICON__ = mergedExpandable.expandIcon; // Customize expandable icon mergedExpandable.expandIcon = mergedExpandable.expandIcon || expandIcon || renderExpandIcon(tableLocale!); // Adjust expand icon index, no overwrite expandIconColumnIndex if set. if (expandType === 'nest' && mergedExpandable.expandIconColumnIndex === undefined) { mergedExpandable.expandIconColumnIndex = rowSelection ? 1 : 0; } else if (mergedExpandable.expandIconColumnIndex! > 0 && rowSelection) { mergedExpandable.expandIconColumnIndex! -= 1; } // Indent size if (typeof mergedExpandable.indentSize !== 'number') { mergedExpandable.indentSize = typeof indentSize === 'number' ? indentSize : 15; } // ============================ Render ============================ const transformColumns = React.useCallback( (innerColumns: ColumnsType): ColumnsType => transformTitleColumns( transformSelectionColumns(transformFilterColumns(transformSorterColumns(innerColumns))), ), [transformSorterColumns, transformFilterColumns, transformSelectionColumns], ); let topPaginationNode: React.ReactNode; let bottomPaginationNode: React.ReactNode; if (pagination !== false && mergedPagination?.total) { let paginationSize: TablePaginationConfig['size']; if (mergedPagination.size) { paginationSize = mergedPagination.size; } else { paginationSize = mergedSize === 'small' || mergedSize === 'middle' ? 'small' : undefined; } const renderPagination = (position: string) => ( ); const defaultPosition = direction === 'rtl' ? 'left' : 'right'; const { position } = mergedPagination; if (position !== null && Array.isArray(position)) { const topPos = position.find((p) => p.includes('top')); const bottomPos = position.find((p) => p.includes('bottom')); const isDisable = position.every((p) => `${p}` === 'none'); if (!topPos && !bottomPos && !isDisable) { bottomPaginationNode = renderPagination(defaultPosition); } if (topPos) { topPaginationNode = renderPagination(topPos.toLowerCase().replace('top', '')); } if (bottomPos) { bottomPaginationNode = renderPagination(bottomPos.toLowerCase().replace('bottom', '')); } } else { bottomPaginationNode = renderPagination(defaultPosition); } } // >>>>>>>>> Spinning let spinProps: SpinProps | undefined; if (typeof loading === 'boolean') { spinProps = { spinning: loading, }; } else if (typeof loading === 'object') { spinProps = { spinning: true, ...loading, }; } const wrapperClassNames = classNames( cssVarCls, rootCls, `${prefixCls}-wrapper`, table?.className, { [`${prefixCls}-wrapper-rtl`]: direction === 'rtl', }, className, rootClassName, hashId, ); const mergedStyle: React.CSSProperties = { ...table?.style, ...style }; const emptyText = typeof locale?.emptyText !== 'undefined' ? locale.emptyText : renderEmpty?.('Table') || ; // ========================== Render ========================== const TableComponent = virtual ? RcVirtualTable : RcTable; // >>> Virtual Table props. We set height here since it will affect height collection const virtualProps: { listItemHeight?: number } = {}; const listItemHeight = React.useMemo(() => { const { fontSize, lineHeight, padding, paddingXS, paddingSM } = token; const fontHeight = Math.floor(fontSize * lineHeight); switch (mergedSize) { case 'large': return padding * 2 + fontHeight; case 'small': return paddingXS * 2 + fontHeight; default: return paddingSM * 2 + fontHeight; } }, [token, mergedSize]); if (virtual) { virtualProps.listItemHeight = listItemHeight; } return wrapCSSVar(
{topPaginationNode} ['columns']} direction={direction} expandable={mergedExpandable} prefixCls={prefixCls} className={classNames( { [`${prefixCls}-middle`]: mergedSize === 'middle', [`${prefixCls}-small`]: mergedSize === 'small', [`${prefixCls}-bordered`]: bordered, [`${prefixCls}-empty`]: rawData.length === 0, }, cssVarCls, rootCls, hashId, )} data={pageData} rowKey={getRowKey} rowClassName={internalRowClassName} emptyText={emptyText} // Internal internalHooks={INTERNAL_HOOKS} internalRefs={internalRefs} transformColumns={transformColumns as any} getContainerWidth={getContainerWidth} /> {bottomPaginationNode}
, ); }; export default React.forwardRef(InternalTable as any) as RefInternalTable;