2017-11-17 14:38:54 +08:00
|
|
|
import * as React from 'react';
|
2018-08-07 21:07:52 +08:00
|
|
|
import * as PropTypes from 'prop-types';
|
2017-08-09 15:45:08 +08:00
|
|
|
import classNames from 'classnames';
|
2017-12-29 10:09:18 +08:00
|
|
|
import { SpinProps } from '../spin';
|
2018-12-26 16:01:00 +08:00
|
|
|
import { ConfigConsumer, ConfigConsumerProps, RenderEmptyHandler } from '../config-provider';
|
2017-08-09 15:45:08 +08:00
|
|
|
|
|
|
|
import Spin from '../spin';
|
2018-05-21 21:52:18 +08:00
|
|
|
import Pagination, { PaginationConfig } from '../pagination';
|
2017-08-14 11:08:19 +08:00
|
|
|
import { Row } from '../grid';
|
2017-08-09 15:45:08 +08:00
|
|
|
|
|
|
|
import Item from './Item';
|
|
|
|
|
2017-09-25 22:14:49 +08:00
|
|
|
export { ListItemProps, ListItemMetaProps } from './Item';
|
|
|
|
|
2017-11-21 19:02:04 +08:00
|
|
|
export type ColumnCount = 1 | 2 | 3 | 4 | 6 | 8 | 12 | 24;
|
|
|
|
|
2018-12-07 20:02:01 +08:00
|
|
|
export type ColumnType = 'gutter' | 'column' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
|
2017-10-10 10:04:03 +08:00
|
|
|
|
2017-08-14 22:25:17 +08:00
|
|
|
export interface ListGridType {
|
2017-08-14 11:08:19 +08:00
|
|
|
gutter?: number;
|
2017-11-21 19:02:04 +08:00
|
|
|
column?: ColumnCount;
|
|
|
|
xs?: ColumnCount;
|
|
|
|
sm?: ColumnCount;
|
|
|
|
md?: ColumnCount;
|
|
|
|
lg?: ColumnCount;
|
|
|
|
xl?: ColumnCount;
|
2018-01-21 01:03:00 +08:00
|
|
|
xxl?: ColumnCount;
|
2017-08-14 11:08:19 +08:00
|
|
|
}
|
|
|
|
|
2017-09-26 16:11:35 +08:00
|
|
|
export type ListSize = 'small' | 'default' | 'large';
|
|
|
|
|
2019-03-17 14:25:34 +08:00
|
|
|
export type ListItemLayout = 'horizontal' | 'vertical';
|
|
|
|
|
2019-03-28 18:55:52 +08:00
|
|
|
export interface ListProps<T> {
|
2017-08-09 15:45:08 +08:00
|
|
|
bordered?: boolean;
|
|
|
|
className?: string;
|
|
|
|
children?: React.ReactNode;
|
2019-03-28 18:55:52 +08:00
|
|
|
dataSource: T[];
|
2017-08-09 15:45:08 +08:00
|
|
|
extra?: React.ReactNode;
|
2017-09-26 16:11:35 +08:00
|
|
|
grid?: ListGridType;
|
2017-08-09 15:45:08 +08:00
|
|
|
id?: string;
|
2019-03-17 14:25:34 +08:00
|
|
|
itemLayout?: ListItemLayout;
|
2017-12-29 10:09:18 +08:00
|
|
|
loading?: boolean | SpinProps;
|
2017-09-25 15:24:16 +08:00
|
|
|
loadMore?: React.ReactNode;
|
2018-12-22 21:21:42 +08:00
|
|
|
pagination?: PaginationConfig | false;
|
2017-08-09 15:45:08 +08:00
|
|
|
prefixCls?: string;
|
2017-09-25 15:24:16 +08:00
|
|
|
rowKey?: any;
|
2019-03-28 18:57:13 +08:00
|
|
|
renderItem: (item: T, index: number) => React.ReactNode;
|
2017-09-26 16:11:35 +08:00
|
|
|
size?: ListSize;
|
|
|
|
split?: boolean;
|
|
|
|
header?: React.ReactNode;
|
|
|
|
footer?: React.ReactNode;
|
2018-12-26 16:01:00 +08:00
|
|
|
locale?: ListLocale;
|
2017-08-09 15:45:08 +08:00
|
|
|
}
|
|
|
|
|
2017-11-21 19:02:04 +08:00
|
|
|
export interface ListLocale {
|
2019-03-21 22:18:58 +08:00
|
|
|
emptyText: React.ReactNode | (() => React.ReactNode);
|
2017-11-21 19:02:04 +08:00
|
|
|
}
|
|
|
|
|
2019-03-28 18:55:52 +08:00
|
|
|
export default class List<T> extends React.Component<ListProps<T>> {
|
2017-08-09 15:45:08 +08:00
|
|
|
static Item: typeof Item = Item;
|
|
|
|
|
2017-09-06 15:53:25 +08:00
|
|
|
static childContextTypes = {
|
|
|
|
grid: PropTypes.any,
|
2019-03-11 23:34:05 +08:00
|
|
|
itemLayout: PropTypes.string,
|
2017-09-06 15:53:25 +08:00
|
|
|
};
|
|
|
|
|
2017-11-17 11:25:29 +08:00
|
|
|
static defaultProps = {
|
|
|
|
dataSource: [],
|
|
|
|
bordered: false,
|
|
|
|
split: true,
|
|
|
|
loading: false,
|
2019-03-28 18:55:52 +08:00
|
|
|
pagination: false as ListProps<any>['pagination'],
|
2017-11-17 11:25:29 +08:00
|
|
|
};
|
|
|
|
|
2018-04-20 15:41:40 +08:00
|
|
|
state = {
|
|
|
|
paginationCurrent: 1,
|
|
|
|
};
|
|
|
|
|
|
|
|
defaultPaginationProps = {
|
|
|
|
current: 1,
|
|
|
|
pageSize: 10,
|
|
|
|
onChange: (page: number, pageSize: number) => {
|
|
|
|
const { pagination } = this.props;
|
|
|
|
this.setState({
|
|
|
|
paginationCurrent: page,
|
|
|
|
});
|
|
|
|
if (pagination && pagination.onChange) {
|
|
|
|
pagination.onChange(page, pageSize);
|
|
|
|
}
|
|
|
|
},
|
|
|
|
total: 0,
|
|
|
|
};
|
|
|
|
|
|
|
|
private keys: { [key: string]: string } = {};
|
2017-09-17 15:48:44 +08:00
|
|
|
|
2017-09-06 15:53:25 +08:00
|
|
|
getChildContext() {
|
|
|
|
return {
|
|
|
|
grid: this.props.grid,
|
2019-03-11 23:34:05 +08:00
|
|
|
itemLayout: this.props.itemLayout,
|
2017-09-06 15:53:25 +08:00
|
|
|
};
|
|
|
|
}
|
|
|
|
|
2019-02-22 10:40:30 +08:00
|
|
|
renderItem = (item: any, index: number) => {
|
|
|
|
const { renderItem, rowKey } = this.props;
|
2017-09-25 15:24:16 +08:00
|
|
|
let key;
|
2017-09-06 15:53:25 +08:00
|
|
|
|
2017-09-25 15:24:16 +08:00
|
|
|
if (typeof rowKey === 'function') {
|
2019-02-22 10:40:30 +08:00
|
|
|
key = rowKey(item);
|
2017-09-25 15:24:16 +08:00
|
|
|
} else if (typeof rowKey === 'string') {
|
2019-02-22 10:40:30 +08:00
|
|
|
key = item[rowKey];
|
2017-09-25 15:24:16 +08:00
|
|
|
} else {
|
2019-02-22 10:40:30 +08:00
|
|
|
key = item.key;
|
2017-09-06 15:53:25 +08:00
|
|
|
}
|
|
|
|
|
2017-09-25 15:24:16 +08:00
|
|
|
if (!key) {
|
|
|
|
key = `list-item-${index}`;
|
2017-09-06 15:53:25 +08:00
|
|
|
}
|
|
|
|
|
2017-09-25 15:24:16 +08:00
|
|
|
this.keys[index] = key;
|
2017-09-06 15:53:25 +08:00
|
|
|
|
2017-09-25 15:24:16 +08:00
|
|
|
return renderItem(item, index);
|
2018-12-07 20:02:01 +08:00
|
|
|
};
|
2017-09-06 15:53:25 +08:00
|
|
|
|
2018-04-13 12:19:11 +08:00
|
|
|
isSomethingAfterLastItem() {
|
2017-10-26 15:36:48 +08:00
|
|
|
const { loadMore, pagination, footer } = this.props;
|
|
|
|
return !!(loadMore || pagination || footer);
|
|
|
|
}
|
|
|
|
|
2018-12-26 16:01:00 +08:00
|
|
|
renderEmpty = (prefixCls: string, renderEmpty: RenderEmptyHandler) => {
|
|
|
|
const { locale } = this.props;
|
|
|
|
|
|
|
|
return (
|
|
|
|
<div className={`${prefixCls}-empty-text`}>
|
|
|
|
{(locale && locale.emptyText) || renderEmpty('List')}
|
|
|
|
</div>
|
|
|
|
);
|
2018-12-07 20:02:01 +08:00
|
|
|
};
|
2017-11-17 11:25:29 +08:00
|
|
|
|
2018-12-26 16:01:00 +08:00
|
|
|
renderList = ({ getPrefixCls, renderEmpty }: ConfigConsumerProps) => {
|
2018-04-20 15:41:40 +08:00
|
|
|
const { paginationCurrent } = this.state;
|
2017-08-09 15:45:08 +08:00
|
|
|
const {
|
2018-12-05 19:12:18 +08:00
|
|
|
prefixCls: customizePrefixCls,
|
2017-11-17 11:25:29 +08:00
|
|
|
bordered,
|
|
|
|
split,
|
2017-08-09 15:45:08 +08:00
|
|
|
className,
|
|
|
|
children,
|
|
|
|
itemLayout,
|
2017-09-25 15:24:16 +08:00
|
|
|
loadMore,
|
2017-11-17 11:25:29 +08:00
|
|
|
pagination,
|
2017-08-14 11:08:19 +08:00
|
|
|
grid,
|
2017-11-17 11:25:29 +08:00
|
|
|
dataSource,
|
2017-09-26 16:11:35 +08:00
|
|
|
size,
|
2017-09-25 15:24:16 +08:00
|
|
|
rowKey,
|
|
|
|
renderItem,
|
2017-09-26 16:11:35 +08:00
|
|
|
header,
|
|
|
|
footer,
|
2017-12-29 10:09:18 +08:00
|
|
|
loading,
|
2018-04-18 00:15:22 +08:00
|
|
|
locale,
|
2018-06-02 20:12:09 +08:00
|
|
|
...rest
|
2017-08-21 21:14:20 +08:00
|
|
|
} = this.props;
|
2017-08-09 15:45:08 +08:00
|
|
|
|
2018-12-05 19:12:18 +08:00
|
|
|
const prefixCls = getPrefixCls('list', customizePrefixCls);
|
2017-12-29 10:09:18 +08:00
|
|
|
let loadingProp = loading;
|
|
|
|
if (typeof loadingProp === 'boolean') {
|
|
|
|
loadingProp = {
|
|
|
|
spinning: loadingProp,
|
|
|
|
};
|
|
|
|
}
|
2018-04-20 15:41:40 +08:00
|
|
|
const isLoading = loadingProp && loadingProp.spinning;
|
2017-12-29 10:09:18 +08:00
|
|
|
|
2017-09-26 16:11:35 +08:00
|
|
|
// large => lg
|
|
|
|
// small => sm
|
|
|
|
let sizeCls = '';
|
|
|
|
switch (size) {
|
|
|
|
case 'large':
|
|
|
|
sizeCls = 'lg';
|
|
|
|
break;
|
|
|
|
case 'small':
|
|
|
|
sizeCls = 'sm';
|
|
|
|
default:
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
2017-08-09 15:45:08 +08:00
|
|
|
const classString = classNames(prefixCls, className, {
|
|
|
|
[`${prefixCls}-vertical`]: itemLayout === 'vertical',
|
2017-09-26 16:11:35 +08:00
|
|
|
[`${prefixCls}-${sizeCls}`]: sizeCls,
|
|
|
|
[`${prefixCls}-split`]: split,
|
2017-08-09 15:45:08 +08:00
|
|
|
[`${prefixCls}-bordered`]: bordered,
|
2017-12-29 10:09:18 +08:00
|
|
|
[`${prefixCls}-loading`]: isLoading,
|
2017-08-14 11:08:19 +08:00
|
|
|
[`${prefixCls}-grid`]: grid,
|
2018-04-13 12:19:11 +08:00
|
|
|
[`${prefixCls}-something-after-last-item`]: this.isSomethingAfterLastItem(),
|
2017-08-09 15:45:08 +08:00
|
|
|
});
|
|
|
|
|
2018-05-04 17:37:31 +08:00
|
|
|
const paginationProps = {
|
|
|
|
...this.defaultPaginationProps,
|
|
|
|
total: dataSource.length,
|
|
|
|
current: paginationCurrent,
|
2018-12-07 20:02:01 +08:00
|
|
|
...(pagination || {}),
|
2018-05-04 17:37:31 +08:00
|
|
|
};
|
2018-05-21 21:52:18 +08:00
|
|
|
|
2018-12-07 20:02:01 +08:00
|
|
|
const largestPage = Math.ceil(paginationProps.total / paginationProps.pageSize);
|
2018-04-20 15:41:40 +08:00
|
|
|
if (paginationProps.current > largestPage) {
|
|
|
|
paginationProps.current = largestPage;
|
|
|
|
}
|
2018-04-19 13:48:55 +08:00
|
|
|
const paginationContent = pagination ? (
|
2017-08-09 15:45:08 +08:00
|
|
|
<div className={`${prefixCls}-pagination`}>
|
2018-12-07 20:02:01 +08:00
|
|
|
<Pagination {...paginationProps} onChange={this.defaultPaginationProps.onChange} />
|
2017-08-09 15:45:08 +08:00
|
|
|
</div>
|
2018-04-19 13:48:55 +08:00
|
|
|
) : null;
|
2017-08-09 15:45:08 +08:00
|
|
|
|
2018-04-20 15:41:40 +08:00
|
|
|
let splitDataSource = [...dataSource];
|
|
|
|
if (pagination) {
|
2018-12-07 20:02:01 +08:00
|
|
|
if (dataSource.length > (paginationProps.current - 1) * paginationProps.pageSize) {
|
2018-04-20 15:41:40 +08:00
|
|
|
splitDataSource = [...dataSource].splice(
|
|
|
|
(paginationProps.current - 1) * paginationProps.pageSize,
|
|
|
|
paginationProps.pageSize,
|
|
|
|
);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-11-17 11:25:29 +08:00
|
|
|
let childrenContent;
|
2018-04-13 15:28:31 +08:00
|
|
|
childrenContent = isLoading && <div style={{ minHeight: 53 }} />;
|
2018-04-20 15:41:40 +08:00
|
|
|
if (splitDataSource.length > 0) {
|
2018-12-07 20:02:01 +08:00
|
|
|
const items = splitDataSource.map((item: any, index: number) => this.renderItem(item, index));
|
2018-09-19 11:05:01 +08:00
|
|
|
|
|
|
|
const childrenList: Array<React.ReactNode> = [];
|
|
|
|
React.Children.forEach(items, (child: any, index) => {
|
2018-12-07 20:02:01 +08:00
|
|
|
childrenList.push(
|
|
|
|
React.cloneElement(child, {
|
|
|
|
key: this.keys[index],
|
|
|
|
}),
|
|
|
|
);
|
2018-09-19 11:05:01 +08:00
|
|
|
});
|
2017-11-17 11:25:29 +08:00
|
|
|
|
2018-12-07 20:02:01 +08:00
|
|
|
childrenContent = grid ? <Row gutter={grid.gutter}>{childrenList}</Row> : childrenList;
|
2017-12-29 10:09:18 +08:00
|
|
|
} else if (!children && !isLoading) {
|
2018-12-26 16:01:00 +08:00
|
|
|
childrenContent = this.renderEmpty(prefixCls, renderEmpty);
|
2017-11-17 11:25:29 +08:00
|
|
|
}
|
2017-08-14 11:08:19 +08:00
|
|
|
|
2018-05-21 21:52:18 +08:00
|
|
|
const paginationPosition = paginationProps.position || 'bottom';
|
|
|
|
|
2017-09-06 15:53:25 +08:00
|
|
|
return (
|
2017-09-25 15:24:16 +08:00
|
|
|
<div className={classString} {...rest}>
|
2018-05-21 21:52:18 +08:00
|
|
|
{(paginationPosition === 'top' || paginationPosition === 'both') && paginationContent}
|
2017-09-26 16:11:35 +08:00
|
|
|
{header && <div className={`${prefixCls}-header`}>{header}</div>}
|
2018-04-19 13:48:55 +08:00
|
|
|
<Spin {...loadingProp}>
|
|
|
|
{childrenContent}
|
|
|
|
{children}
|
|
|
|
</Spin>
|
2017-09-26 16:11:35 +08:00
|
|
|
{footer && <div className={`${prefixCls}-footer`}>{footer}</div>}
|
2018-12-07 20:02:01 +08:00
|
|
|
{loadMore ||
|
|
|
|
((paginationPosition === 'bottom' || paginationPosition === 'both') && paginationContent)}
|
2017-08-09 15:45:08 +08:00
|
|
|
</div>
|
|
|
|
);
|
2018-12-07 20:02:01 +08:00
|
|
|
};
|
2018-12-05 19:12:18 +08:00
|
|
|
|
|
|
|
render() {
|
2018-12-07 20:02:01 +08:00
|
|
|
return <ConfigConsumer>{this.renderList}</ConfigConsumer>;
|
2018-12-05 19:12:18 +08:00
|
|
|
}
|
2017-08-09 15:45:08 +08:00
|
|
|
}
|