index.tsx 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293
  1. /* eslint-disable max-len */
  2. import React from 'react';
  3. import cls from 'classnames';
  4. import propTypes from 'prop-types';
  5. import { cssClasses, strings } from '@douyinfe/semi-foundation/breadcrumb/constants';
  6. import BreadcrumbFoundation, { BreadcrumbAdapter } from '@douyinfe/semi-foundation/breadcrumb/foundation';
  7. import warning from '@douyinfe/semi-foundation/utils/warning';
  8. import { isFunction } from 'lodash-es';
  9. import '@douyinfe/semi-foundation/breadcrumb/breadcrumb.scss';
  10. import { noop } from '@douyinfe/semi-foundation/utils/function';
  11. import BaseComponent, { BaseProps } from '../_base/baseComponent';
  12. import Popover from '../popover';
  13. import BreadcrumbItem, { RouteProps, BreadcrumbItemInfo } from './item';
  14. import BreadContext, { BreadContextProps } from './bread-context';
  15. import { TooltipProps } from '../tooltip';
  16. import { IconMore } from '@douyinfe/semi-icons';
  17. const clsPrefix = cssClasses.PREFIX;
  18. export { RouteProps, BreadcrumbItemProps, BreadcrumbItemInfo } from './item';
  19. export interface showToolTipProps {
  20. width?: string | number;
  21. ellipsisPos?: 'end' | 'middle';
  22. opts?: TooltipProps;
  23. }
  24. export type MoreType = 'default' | 'popover';
  25. export interface BreadcrumbProps extends BaseProps {
  26. routes?: Array<RouteProps | string>;
  27. onClick?: (route: RouteProps, event: React.MouseEvent) => void;
  28. separator?: React.ReactNode;
  29. compact?: boolean;
  30. style?: React.CSSProperties;
  31. renderItem?: (route: RouteProps) => React.ReactNode;
  32. className?: string;
  33. showTooltip?: boolean | showToolTipProps;
  34. maxItemCount?: number;
  35. autoCollapse?: boolean;
  36. /* Customize the contents of the ellipsis area */
  37. renderMore?: (restItem: Array<React.ReactNode>) => React.ReactNode;
  38. /* Style type for ellipsis area */
  39. moreType?: MoreType;
  40. }
  41. interface BreadcrumbState {
  42. isCollapsed: boolean;
  43. }
  44. class Breadcrumb extends BaseComponent<BreadcrumbProps, BreadcrumbState> {
  45. static contextType: React.Context<BreadContextProps> = BreadContext;
  46. static Item: typeof BreadcrumbItem = BreadcrumbItem;
  47. static propTypes = {
  48. routes: propTypes.array,
  49. onClick: propTypes.func,
  50. separator: propTypes.node,
  51. compact: propTypes.bool,
  52. children: propTypes.node,
  53. style: propTypes.object,
  54. renderItem: propTypes.func,
  55. showTooltip: propTypes.oneOfType([
  56. propTypes.shape({
  57. width: propTypes.oneOfType([propTypes.string, propTypes.number]),
  58. ellipsisPos: propTypes.oneOf(['end', 'middle']),
  59. opts: propTypes.object,
  60. }),
  61. propTypes.bool,
  62. ]),
  63. className: propTypes.string,
  64. autoCollapse: propTypes.bool,
  65. maxItemCount: propTypes.number,
  66. /* Customize the contents of the ellipsis area */
  67. renderMore: propTypes.func,
  68. /* Type of ellipsis area */
  69. moreType: propTypes.oneOf(strings.MORE_TYPE),
  70. };
  71. static defaultProps = {
  72. routes: [] as [],
  73. onClick: noop,
  74. renderItem: undefined as undefined,
  75. separator: '/',
  76. compact: true,
  77. showTooltip: {
  78. width: 150,
  79. ellipsisPos: 'end',
  80. },
  81. autoCollapse: true,
  82. moreType: 'default',
  83. maxItemCount: 4,
  84. };
  85. constructor(props: BreadcrumbProps) {
  86. super(props);
  87. this.foundation = new BreadcrumbFoundation(this.adapter);
  88. this.state = {
  89. isCollapsed: true,
  90. };
  91. this.onClick = this.onClick.bind(this);
  92. }
  93. get adapter(): BreadcrumbAdapter<BreadcrumbProps, BreadcrumbState> {
  94. return {
  95. ...super.adapter,
  96. notifyClick: (...args) => {
  97. this.props.onClick(...args);
  98. },
  99. expandCollapsed: () =>
  100. this.setState({
  101. isCollapsed: false,
  102. }),
  103. };
  104. }
  105. componentDidMount() {
  106. this.foundation.init();
  107. }
  108. componentWillUnmount() {
  109. this.foundation.destroy();
  110. }
  111. renderPopoverMore(restItem: Array<React.ReactNode>) {
  112. const { separator } = this.props;
  113. const content = (
  114. <>
  115. {
  116. restItem.map((item: React.ReactNode, idx: number) => (
  117. <React.Fragment key={`restItem-${idx}`}>
  118. {item}
  119. {idx !== restItem.length - 1 &&
  120. (
  121. <span className={`${clsPrefix}-restItem`}>
  122. {separator}
  123. </span>
  124. )
  125. }
  126. </React.Fragment>
  127. ))
  128. }
  129. </>
  130. );
  131. return (
  132. <Popover
  133. content={content}
  134. style={{
  135. padding: 12,
  136. }}
  137. showArrow
  138. >
  139. <IconMore />
  140. </Popover>
  141. );
  142. }
  143. handleCollapse = (template: Array<React.ReactNode>, itemsLen: number) => {
  144. const { maxItemCount, renderMore, moreType } = this.props;
  145. const hasRenderMore = isFunction(renderMore);
  146. const restItem = template.slice(1, itemsLen - 3);
  147. const spread = (
  148. <span className={`${clsPrefix}-collapse`} key={`more-${itemsLen}`}>
  149. <span className={`${clsPrefix}-item-wrap`}>
  150. <span
  151. className={`${clsPrefix}-item ${clsPrefix}-item-more`}
  152. onClick={item => this.foundation.handleExpand(item)}
  153. >
  154. {hasRenderMore && renderMore(restItem)}
  155. {!hasRenderMore && moreType === 'default' && <IconMore />}
  156. {!hasRenderMore && moreType === 'popover' && this.renderPopoverMore(restItem)}
  157. </span>
  158. <span className={`${clsPrefix}-separator`}>{this.props.separator}</span>
  159. </span>
  160. </span>
  161. );
  162. template.splice(1, itemsLen - maxItemCount, spread);
  163. return template;
  164. };
  165. renderRouteItems = (items: Array<RouteProps>, shouldCollapse: boolean, moreTypeIsPopover: boolean) => {
  166. const { renderItem, renderMore, maxItemCount } = this.props;
  167. const restItemLength = items.length - maxItemCount;
  168. const hasRenderMore = isFunction(renderMore);
  169. const template = (
  170. items.map((route, idx: number) => {
  171. const key = route._origin.key || `item-${route.name || route.path}-${idx}`;
  172. const inCollapseArea = idx > 0 && idx <= restItemLength;
  173. return (
  174. <BreadcrumbItem
  175. {...route}
  176. key={key}
  177. active={idx === items.length - 1}
  178. route={route._origin}
  179. // eslint-disable-next-line max-len
  180. shouldRenderSeparator={!(shouldCollapse && (hasRenderMore || moreTypeIsPopover) && inCollapseArea)}
  181. >
  182. {renderItem ? renderItem(route._origin) : route.name}
  183. </BreadcrumbItem>
  184. );
  185. })
  186. );
  187. return template;
  188. };
  189. renderList = (): Array<React.ReactNode> => {
  190. const {
  191. routes,
  192. children,
  193. autoCollapse,
  194. maxItemCount,
  195. renderMore,
  196. moreType
  197. } = this.props;
  198. const { isCollapsed } = this.state;
  199. const hasRoutes = routes && routes.length > 0;
  200. const items = hasRoutes ?
  201. this.foundation.genRoutes(routes) :
  202. React.Children.toArray(children);
  203. let template;
  204. const itemLength = items.length; // children length
  205. const restItemLength = itemLength - maxItemCount; // Omitted children items
  206. const shouldCollapse = items && autoCollapse && itemLength > maxItemCount && isCollapsed; // Whether the number of children exceeds, need to collapse
  207. const hasRenderMore = isFunction(renderMore); // Whether the user passes in the renderMore method
  208. const moreTypeIsPopover = moreType === 'popover';
  209. if (hasRoutes) {
  210. template = this.renderRouteItems(items, shouldCollapse, moreTypeIsPopover);
  211. } else {
  212. template = (
  213. items.map((item: any, idx: number) => {
  214. const inCollapseArea = idx > 0 && idx <= restItemLength;
  215. if (!item) {
  216. return item;
  217. }
  218. warning(
  219. item.type && !item.type.isBreadcrumbItem,
  220. '[Semi Breadcrumb]: Only accepts Breadcrumb.Item as its children'
  221. );
  222. return React.cloneElement(item, {
  223. key: `${idx}-item`,
  224. active: idx === items.length - 1,
  225. shouldRenderSeparator: !(shouldCollapse && (hasRenderMore || moreTypeIsPopover) && inCollapseArea)
  226. });
  227. })
  228. );
  229. }
  230. if (shouldCollapse) {
  231. return this.handleCollapse(template, items.length);
  232. }
  233. return template;
  234. };
  235. onClick = (info: BreadcrumbItemInfo, event: React.MouseEvent) => {
  236. this.foundation.handleClick(info, event);
  237. };
  238. render() {
  239. const breadcrumbs = this.renderList();
  240. const { compact, className, style, separator, showTooltip } = this.props;
  241. const sizeCls = cls(className,
  242. {
  243. [`${clsPrefix}-wrapper`]: true,
  244. [`${clsPrefix}-wrapper-compact`]: compact,
  245. [`${clsPrefix}-wrapper-loose`]: !compact
  246. }
  247. );
  248. return (
  249. <BreadContext.Provider
  250. value={{
  251. onClick: this.onClick,
  252. showTooltip,
  253. compact,
  254. separator,
  255. }}
  256. >
  257. <nav aria-label={`${clsPrefix}`} className={sizeCls} style={style}>
  258. {breadcrumbs}
  259. </nav>
  260. </BreadContext.Provider>
  261. );
  262. }
  263. }
  264. export default Breadcrumb;