import * as React from 'react'; import classNames from 'classnames'; import toArray from 'rc-util/lib/Children/toArray'; import warning from '../_util/warning'; import ResponsiveObserve, { Breakpoint, BreakpointMap, responsiveArray, } from '../_util/responsiveObserve'; import { ConfigConsumer, ConfigConsumerProps } from '../config-provider'; import Col from './Col'; export interface DescriptionsItemProps { prefixCls?: string; className?: string; label?: React.ReactNode; children: React.ReactNode; span?: number; } const DescriptionsItem: React.SFC = ({ children }) => children as JSX.Element; export interface DescriptionsProps { prefixCls?: string; className?: string; style?: React.CSSProperties; bordered?: boolean; size?: 'middle' | 'small' | 'default'; children?: React.ReactNode; title?: React.ReactNode; column?: number | Partial>; layout?: 'horizontal' | 'vertical'; colon?: boolean; } /** * Convert children into `column` groups. * @param children: DescriptionsItem * @param column: number */ const generateChildrenRows = ( children: React.ReactNode, column: number, ): React.ReactElement[][] => { const rows: React.ReactElement[][] = []; let columns: React.ReactElement[] | null = null; let leftSpans: number; const itemNodes = toArray(children); itemNodes.forEach((node: React.ReactElement, index: number) => { let itemNode = node; if (!columns) { leftSpans = column; columns = []; rows.push(columns); } // Always set last span to align the end of Descriptions const lastItem = index === itemNodes.length - 1; let lastSpanSame = true; if (lastItem) { lastSpanSame = !itemNode.props.span || itemNode.props.span === leftSpans; itemNode = React.cloneElement(itemNode, { span: leftSpans, }); } // Calculate left fill span const { span = 1 } = itemNode.props; columns.push(itemNode); leftSpans -= span; if (leftSpans <= 0) { columns = null; warning( leftSpans === 0 && lastSpanSame, 'Descriptions', 'Sum of column `span` in a line exceeds `column` of Descriptions.', ); } }); return rows; }; const renderRow = ( children: React.ReactElement[], index: number, { prefixCls }: { prefixCls: string }, bordered: boolean, layout: 'horizontal' | 'vertical', colon: boolean, ) => { const renderCol = ( colItem: React.ReactElement, type: 'label' | 'content', idx: number, ) => { return ( ); }; const cloneChildren: JSX.Element[] = []; const cloneContentChildren: JSX.Element[] = []; toArray(children).forEach( (childrenItem: React.ReactElement, idx: number) => { cloneChildren.push(renderCol(childrenItem, 'label', idx)); if (layout === 'vertical') { cloneContentChildren.push(renderCol(childrenItem, 'content', idx)); } else if (bordered) { cloneChildren.push(renderCol(childrenItem, 'content', idx)); } }, ); if (layout === 'vertical') { return [ {cloneChildren} , {cloneContentChildren} , ]; } return ( {cloneChildren} ); }; const defaultColumnMap = { xxl: 3, xl: 3, lg: 3, md: 3, sm: 2, xs: 1, }; class Descriptions extends React.Component< DescriptionsProps, { screens: BreakpointMap; } > { static defaultProps: DescriptionsProps = { size: 'default', column: defaultColumnMap, }; static Item: typeof DescriptionsItem = DescriptionsItem; state: { screens: BreakpointMap; } = { screens: {}, }; token: string; componentDidMount() { const { column } = this.props; this.token = ResponsiveObserve.subscribe(screens => { if (typeof column !== 'object') { return; } this.setState({ screens, }); }); } componentWillUnmount() { ResponsiveObserve.unsubscribe(this.token); } getColumn(): number { const { column } = this.props; if (typeof column === 'object') { for (let i = 0; i < responsiveArray.length; i++) { const breakpoint: Breakpoint = responsiveArray[i]; if (this.state.screens[breakpoint] && column[breakpoint] !== undefined) { return column[breakpoint] || defaultColumnMap[breakpoint]; } } } // If the configuration is not an object, it is a number, return number if (typeof column === 'number') { return column as number; } // If it is an object, but no response is found, this happens only in the test. // Maybe there are some strange environments return 3; } render() { return ( {({ getPrefixCls }: ConfigConsumerProps) => { const { className, prefixCls: customizePrefixCls, title, size, children, bordered = false, layout = 'horizontal', colon = true, style, } = this.props; const prefixCls = getPrefixCls('descriptions', customizePrefixCls); const column = this.getColumn(); const cloneChildren = toArray(children) .map((child: React.ReactElement) => { if (React.isValidElement(child)) { return React.cloneElement(child, { prefixCls, }); } return null; }) .filter((node: React.ReactElement) => node); const childrenArray: Array< React.ReactElement[] > = generateChildrenRows(cloneChildren, column); return (
{title &&
{title}
}
{childrenArray.map((child, index) => renderRow( child, index, { prefixCls, }, bordered, layout, colon, ), )}
); }}
); } } export default Descriptions;