import * as React from 'react'; import classNames from 'classnames'; import toArray from 'rc-util/lib/Children/toArray'; import copy from 'copy-to-clipboard'; import omit from 'rc-util/lib/omit'; import EditOutlined from '@ant-design/icons/EditOutlined'; import CheckOutlined from '@ant-design/icons/CheckOutlined'; import CopyOutlined from '@ant-design/icons/CopyOutlined'; import ResizeObserver from 'rc-resize-observer'; import { AutoSizeType } from 'rc-textarea/lib/ResizableTextArea'; import { ConfigConsumerProps, configConsumerProps, ConfigContext } from '../config-provider'; import LocaleReceiver from '../locale-provider/LocaleReceiver'; import devWarning from '../_util/devWarning'; import TransButton from '../_util/transButton'; import raf from '../_util/raf'; import { isStyleSupport } from '../_util/styleChecker'; import Tooltip from '../tooltip'; import Typography, { TypographyProps } from './Typography'; import Editable from './Editable'; import measure from './util'; export type BaseType = 'secondary' | 'success' | 'warning' | 'danger'; const isLineClampSupport = isStyleSupport('webkitLineClamp'); const isTextOverflowSupport = isStyleSupport('textOverflow'); interface CopyConfig { text?: string; onCopy?: () => void; icon?: React.ReactNode; tooltips?: boolean | React.ReactNode; } interface EditConfig { editing?: boolean; icon?: React.ReactNode; tooltip?: boolean | React.ReactNode; onStart?: () => void; onChange?: (value: string) => void; onCancel?: () => void; onEnd?: () => void; maxLength?: number; autoSize?: boolean | AutoSizeType; } export interface EllipsisConfig { rows?: number; expandable?: boolean; suffix?: string; symbol?: React.ReactNode; onExpand?: React.MouseEventHandler; onEllipsis?: (ellipsis: boolean) => void; tooltip?: React.ReactNode; } export interface BlockProps extends TypographyProps { title?: string; editable?: boolean | EditConfig; copyable?: boolean | CopyConfig; type?: BaseType; disabled?: boolean; ellipsis?: boolean | EllipsisConfig; // decorations code?: boolean; mark?: boolean; underline?: boolean; delete?: boolean; strong?: boolean; keyboard?: boolean; italic?: boolean; } function wrapperDecorations( { mark, code, underline, delete: del, strong, keyboard, italic }: BlockProps, content: React.ReactNode, ) { let currentContent = content; function wrap(needed: boolean | undefined, tag: string) { if (!needed) return; currentContent = React.createElement(tag, {}, currentContent); } wrap(strong, 'strong'); wrap(underline, 'u'); wrap(del, 'del'); wrap(code, 'code'); wrap(mark, 'mark'); wrap(keyboard, 'kbd'); wrap(italic, 'i'); return currentContent; } function getNode(dom: React.ReactNode, defaultNode: React.ReactNode, needDom?: boolean) { if (dom === true || dom === undefined) { return defaultNode; } return dom || (needDom && defaultNode); } interface InternalBlockProps extends BlockProps { component: string; } interface BaseState { edit: boolean; copied: boolean; ellipsisText: string; ellipsisContent: React.ReactNode; isEllipsis: boolean; expanded: boolean; clientRendered: boolean; } interface Locale { edit?: string; copy?: string; copied?: string; expand?: string; } const ELLIPSIS_STR = '...'; class Base extends React.Component { static contextType = ConfigContext; static defaultProps = { children: '', }; static getDerivedStateFromProps(nextProps: BlockProps) { const { children, editable } = nextProps; devWarning( !editable || typeof children === 'string', 'Typography', 'When `editable` is enabled, the `children` should use string.', ); return {}; } context: ConfigConsumerProps; editIcon?: HTMLDivElement; contentRef = React.createRef(); copyId?: number; rafId?: number; // Locale expandStr?: string; copyStr?: string; copiedStr?: string; editStr?: string; state: BaseState = { edit: false, copied: false, ellipsisText: '', ellipsisContent: null, isEllipsis: false, expanded: false, clientRendered: false, }; componentDidMount() { this.setState({ clientRendered: true }); this.resizeOnNextFrame(); } componentDidUpdate(prevProps: BlockProps) { const { children } = this.props; const ellipsis = this.getEllipsis(); const prevEllipsis = this.getEllipsis(prevProps); if (children !== prevProps.children || ellipsis.rows !== prevEllipsis.rows) { this.resizeOnNextFrame(); } } componentWillUnmount() { window.clearTimeout(this.copyId); raf.cancel(this.rafId); } getPrefixCls = () => { const { prefixCls: customizePrefixCls } = this.props; const { getPrefixCls } = this.context; return getPrefixCls('typography', customizePrefixCls); }; // =============== Expand =============== onExpandClick: React.MouseEventHandler = e => { const { onExpand } = this.getEllipsis(); this.setState({ expanded: true }); (onExpand as React.MouseEventHandler)?.(e); }; // ================ Edit ================ onEditClick = (e: React.MouseEvent) => { e.preventDefault(); this.triggerEdit(true); }; onEditChange = (value: string) => { const { onChange } = this.getEditable(); onChange?.(value); this.triggerEdit(false); }; onEditCancel = () => { this.getEditable().onCancel?.(); this.triggerEdit(false); }; // ================ Copy ================ onCopyClick = (e: React.MouseEvent) => { e.preventDefault(); const { children, copyable } = this.props; const copyConfig: CopyConfig = { ...(typeof copyable === 'object' ? copyable : null), }; if (copyConfig.text === undefined) { copyConfig.text = String(children); } copy(copyConfig.text || ''); this.setState({ copied: true }, () => { if (copyConfig.onCopy) { copyConfig.onCopy(); } this.copyId = window.setTimeout(() => { this.setState({ copied: false }); }, 3000); }); }; getEditable(props?: BlockProps): EditConfig { const { edit } = this.state; const { editable } = props || this.props; if (!editable) return { editing: edit }; return { editing: edit, ...(typeof editable === 'object' ? editable : null), }; } getEllipsis(props?: BlockProps): EllipsisConfig { const { ellipsis } = props || this.props; if (!ellipsis) return {}; return { rows: 1, expandable: false, ...(typeof ellipsis === 'object' ? ellipsis : null), }; } setEditRef = (node: HTMLDivElement) => { this.editIcon = node; }; triggerEdit = (edit: boolean) => { const { onStart } = this.getEditable(); if (edit && onStart) { onStart(); } this.setState({ edit }, () => { if (!edit && this.editIcon) { this.editIcon.focus(); } }); }; // ============== Ellipsis ============== resizeOnNextFrame = () => { raf.cancel(this.rafId); this.rafId = raf(() => { // Do not bind `syncEllipsis`. It need for test usage on prototype this.syncEllipsis(); }); }; canUseCSSEllipsis(): boolean { const { clientRendered } = this.state; const { editable, copyable } = this.props; const { rows, expandable, suffix, onEllipsis, tooltip } = this.getEllipsis(); if (suffix || tooltip) return false; // Can't use css ellipsis since we need to provide the place for button if (editable || copyable || expandable || !clientRendered || onEllipsis) { return false; } if (rows === 1) { return isTextOverflowSupport; } return isLineClampSupport; } syncEllipsis() { const { ellipsisText, isEllipsis, expanded } = this.state; const { rows, suffix, onEllipsis } = this.getEllipsis(); const { children } = this.props; if (!rows || rows < 0 || !this.contentRef.current || expanded) return; // Do not measure if css already support ellipsis if (this.canUseCSSEllipsis()) return; devWarning( toArray(children).every((child: React.ReactNode) => typeof child === 'string'), 'Typography', '`ellipsis` should use string as children only.', ); const { content, text, ellipsis } = measure( this.contentRef.current, { rows, suffix }, children, this.renderOperations(true), ELLIPSIS_STR, ); if (ellipsisText !== text || isEllipsis !== ellipsis) { this.setState({ ellipsisText: text, ellipsisContent: content, isEllipsis: ellipsis }); if (isEllipsis !== ellipsis && onEllipsis) { onEllipsis(ellipsis); } } } renderExpand(forceRender?: boolean) { const { expandable, symbol } = this.getEllipsis(); const { expanded, isEllipsis } = this.state; if (!expandable) return null; // force render expand icon for measure usage or it will cause dead loop if (!forceRender && (expanded || !isEllipsis)) return null; let expandContent: React.ReactNode; if (symbol) { expandContent = symbol; } else { expandContent = this.expandStr; } return ( {expandContent} ); } renderEdit() { const { editable } = this.props; if (!editable) return; const { icon, tooltip } = editable as EditConfig; const title = toArray(tooltip)[0] || this.editStr; const ariaLabel = typeof title === 'string' ? title : ''; return ( {icon || } ); } renderCopy() { const { copied } = this.state; const { copyable } = this.props; if (!copyable) return; const prefixCls = this.getPrefixCls(); const { tooltips, icon } = copyable as CopyConfig; const tooltipNodes = Array.isArray(tooltips) ? tooltips : [tooltips]; const iconNodes = Array.isArray(icon) ? icon : [icon]; const title = copied ? getNode(tooltipNodes[1], this.copiedStr) : getNode(tooltipNodes[0], this.copyStr); const systemStr = copied ? this.copiedStr : this.copyStr; const ariaLabel = typeof title === 'string' ? title : systemStr; return ( {copied ? getNode(iconNodes[1], , true) : getNode(iconNodes[0], , true)} ); } renderEditInput() { const { children, className, style } = this.props; const { direction } = this.context; const { maxLength, autoSize, onEnd } = this.getEditable(); return ( ); } renderOperations(forceRenderExpanded?: boolean) { return [this.renderExpand(forceRenderExpanded), this.renderEdit(), this.renderCopy()].filter( node => node, ); } renderContent() { const { ellipsisContent, isEllipsis, expanded } = this.state; const { component, children, className, type, disabled, style, ...restProps } = this.props; const { direction } = this.context; const { rows, suffix, tooltip } = this.getEllipsis(); const prefixCls = this.getPrefixCls(); const textProps = omit(restProps, [ 'prefixCls', 'editable', 'copyable', 'ellipsis', 'mark', 'code', 'delete', 'underline', 'strong', 'keyboard', 'italic', ...(configConsumerProps as any), ]) as any; const cssEllipsis = this.canUseCSSEllipsis(); const cssTextOverflow = rows === 1 && cssEllipsis; const cssLineClamp = rows && rows > 1 && cssEllipsis; let textNode: React.ReactNode = children; // Only use js ellipsis when css ellipsis not support if (rows && isEllipsis && !expanded && !cssEllipsis) { const { title } = restProps; let restContent = title || ''; if (!title && (typeof children === 'string' || typeof children === 'number')) { restContent = String(children); } // show rest content as title on symbol restContent = restContent.slice(String(ellipsisContent || '').length); // We move full content to outer element to avoid repeat read the content by accessibility textNode = ( <> {ellipsisContent} {suffix} ); // If provided tooltip, we need wrap with span to let Tooltip inject events if (tooltip) { textNode = ( {textNode} ); } } else { textNode = ( <> {children} {suffix} ); } textNode = wrapperDecorations(this.props, textNode); return ( {({ edit, copy: copyStr, copied, expand }: Locale) => { this.editStr = edit; this.copyStr = copyStr; this.copiedStr = copied; this.expandStr = expand; return ( {textNode} {this.renderOperations()} ); }} ); } render() { const { editing } = this.getEditable(); if (editing) { return this.renderEditInput(); } return this.renderContent(); } } export default Base;