import classNames from 'classnames'; import * as React from 'react'; import extendsObject from '../_util/extendsObject'; import type { Breakpoint } from '../_util/responsiveObserver'; import { responsiveArray } from '../_util/responsiveObserver'; import { ConfigContext } from '../config-provider'; import DefaultRenderEmpty from '../config-provider/defaultRenderEmpty'; import { Row } from '../grid'; import type { RowProps } from '../grid'; import useBreakpoint from '../grid/hooks/useBreakpoint'; import type { PaginationConfig } from '../pagination'; import Pagination from '../pagination'; import type { SpinProps } from '../spin'; import Spin from '../spin'; import Item from './Item'; import { ListContext } from './context'; import useStyle from './style'; import useSize from '../config-provider/hooks/useSize'; export type { ListItemMetaProps, ListItemProps } from './Item'; export type { ListConsumerProps } from './context'; export type ColumnCount = number; export type ColumnType = 'gutter' | 'column' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl'; export interface ListGridType { gutter?: RowProps['gutter']; column?: ColumnCount; xs?: ColumnCount; sm?: ColumnCount; md?: ColumnCount; lg?: ColumnCount; xl?: ColumnCount; xxl?: ColumnCount; } export type ListSize = 'small' | 'default' | 'large'; export type ListItemLayout = 'horizontal' | 'vertical'; export interface ListProps { bordered?: boolean; className?: string; rootClassName?: string; style?: React.CSSProperties; children?: React.ReactNode; dataSource?: T[]; extra?: React.ReactNode; grid?: ListGridType; id?: string; itemLayout?: ListItemLayout; loading?: boolean | SpinProps; loadMore?: React.ReactNode; pagination?: PaginationConfig | false; prefixCls?: string; rowKey?: ((item: T) => React.Key) | keyof T; renderItem?: (item: T, index: number) => React.ReactNode; size?: ListSize; split?: boolean; header?: React.ReactNode; footer?: React.ReactNode; locale?: ListLocale; } export interface ListLocale { emptyText: React.ReactNode; } function List({ pagination = false as ListProps['pagination'], prefixCls: customizePrefixCls, bordered = false, split = true, className, rootClassName, style, children, itemLayout, loadMore, grid, dataSource = [], size: customizeSize, header, footer, loading = false, rowKey, renderItem, locale, ...rest }: ListProps) { const paginationObj = pagination && typeof pagination === 'object' ? pagination : {}; const [paginationCurrent, setPaginationCurrent] = React.useState( paginationObj.defaultCurrent || 1, ); const [paginationSize, setPaginationSize] = React.useState(paginationObj.defaultPageSize || 10); const { getPrefixCls, renderEmpty, direction, list } = React.useContext(ConfigContext); const defaultPaginationProps = { current: 1, total: 0, }; const triggerPaginationEvent = (eventName: 'onChange' | 'onShowSizeChange') => (page: number, pageSize: number) => { setPaginationCurrent(page); setPaginationSize(pageSize); if (pagination && pagination[eventName]) { pagination?.[eventName]?.(page, pageSize); } }; const onPaginationChange = triggerPaginationEvent('onChange'); const onPaginationShowSizeChange = triggerPaginationEvent('onShowSizeChange'); const renderInnerItem = (item: T, index: number) => { if (!renderItem) return null; let key; if (typeof rowKey === 'function') { key = rowKey(item); } else if (rowKey) { key = item[rowKey]; } else { key = (item as any).key; } if (!key) { key = `list-item-${index}`; } return {renderItem(item, index)}; }; const isSomethingAfterLastItem = () => !!(loadMore || pagination || footer); const prefixCls = getPrefixCls('list', customizePrefixCls); // Style const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls); let loadingProp = loading; if (typeof loadingProp === 'boolean') { loadingProp = { spinning: loadingProp, }; } const isLoading = loadingProp && loadingProp.spinning; const mergedSize = useSize(customizeSize); // large => lg // small => sm let sizeCls = ''; switch (mergedSize) { case 'large': sizeCls = 'lg'; break; case 'small': sizeCls = 'sm'; break; default: break; } const classString = classNames( prefixCls, { [`${prefixCls}-vertical`]: itemLayout === 'vertical', [`${prefixCls}-${sizeCls}`]: sizeCls, [`${prefixCls}-split`]: split, [`${prefixCls}-bordered`]: bordered, [`${prefixCls}-loading`]: isLoading, [`${prefixCls}-grid`]: !!grid, [`${prefixCls}-something-after-last-item`]: isSomethingAfterLastItem(), [`${prefixCls}-rtl`]: direction === 'rtl', }, list?.className, className, rootClassName, hashId, cssVarCls, ); const paginationProps = extendsObject( defaultPaginationProps, { total: dataSource.length, current: paginationCurrent, pageSize: paginationSize, }, pagination || {}, ); const largestPage = Math.ceil(paginationProps.total / paginationProps.pageSize); if (paginationProps.current > largestPage) { paginationProps.current = largestPage; } const paginationContent = pagination ? (
) : null; let splitDataSource = [...dataSource]; if (pagination) { if (dataSource.length > (paginationProps.current - 1) * paginationProps.pageSize) { splitDataSource = [...dataSource].splice( (paginationProps.current - 1) * paginationProps.pageSize, paginationProps.pageSize, ); } } const needResponsive = Object.keys(grid || {}).some((key) => ['xs', 'sm', 'md', 'lg', 'xl', 'xxl'].includes(key), ); const screens = useBreakpoint(needResponsive); const currentBreakpoint = React.useMemo(() => { for (let i = 0; i < responsiveArray.length; i += 1) { const breakpoint: Breakpoint = responsiveArray[i]; if (screens[breakpoint]) { return breakpoint; } } return undefined; }, [screens]); const colStyle = React.useMemo(() => { if (!grid) { return undefined; } const columnCount = currentBreakpoint && grid[currentBreakpoint] ? grid[currentBreakpoint] : grid.column; if (columnCount) { return { width: `${100 / columnCount}%`, maxWidth: `${100 / columnCount}%`, }; } }, [grid?.column, currentBreakpoint]); let childrenContent: React.ReactNode = isLoading &&
; if (splitDataSource.length > 0) { const items = splitDataSource.map((item: T, index: number) => renderInnerItem(item, index)); childrenContent = grid ? ( {React.Children.map(items, (child) => (
{child}
))}
) : (
    {items}
); } else if (!children && !isLoading) { childrenContent = (
{(locale && locale.emptyText) || renderEmpty?.('List') || ( )}
); } const paginationPosition = paginationProps.position || 'bottom'; const contextValue = React.useMemo( () => ({ grid, itemLayout }), [JSON.stringify(grid), itemLayout], ); return wrapCSSVar(
{(paginationPosition === 'top' || paginationPosition === 'both') && paginationContent} {header &&
{header}
} {childrenContent} {children} {footer &&
{footer}
} {loadMore || ((paginationPosition === 'bottom' || paginationPosition === 'both') && paginationContent)}
, ); } if (process.env.NODE_ENV !== 'production') { List.displayName = 'List'; } List.Item = Item; export default List;