/* * Copyright 2018 Palantir Technologies, Inc. All rights reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import classNames from "classnames"; import * as React from "react"; import { polyfill } from "react-lifecycles-compat"; import { AbstractPureComponent2, Boundary, Classes, Props, Position, removeNonHTMLProps } from "../../common"; import { Menu } from "../menu/menu"; import { MenuItem } from "../menu/menuItem"; import { OverflowListProps, OverflowList } from "../overflow-list/overflowList"; import { IPopoverProps, Popover } from "../popover/popover"; import { Breadcrumb, BreadcrumbProps } from "./breadcrumb"; // eslint-disable-next-line deprecation/deprecation export type BreadcrumbsProps = IBreadcrumbsProps; /** @deprecated use BreadcrumbsProps */ export interface IBreadcrumbsProps extends Props { /** * Callback invoked to render visible breadcrumbs. Best practice is to * render a `` element. If `currentBreadcrumbRenderer` is also * supplied, that callback will be used for the current breadcrumb instead. * * @default Breadcrumb */ breadcrumbRenderer?: (props: BreadcrumbProps) => JSX.Element; /** * Which direction the breadcrumbs should collapse from: start or end. * * @default Boundary.START */ collapseFrom?: Boundary; /** * Callback invoked to render the current breadcrumb, which is the last * element in the `items` array. * * If this prop is omitted, `breadcrumbRenderer` will be invoked for the * current breadcrumb instead. */ currentBreadcrumbRenderer?: (props: BreadcrumbProps) => JSX.Element; /** * All breadcrumbs to display. Breadcrumbs that do not fit in the container * will be rendered in an overflow menu instead. */ items: BreadcrumbProps[]; /** * The minimum number of visible breadcrumbs that should never collapse into * the overflow menu, regardless of DOM dimensions. * * @default 0 */ minVisibleItems?: number; /** * Props to spread to `OverflowList`. Note that `items`, * `overflowRenderer`, and `visibleItemRenderer` cannot be changed. */ overflowListProps?: Partial>; /** * Props to spread to the `Popover` showing the overflow menu. */ popoverProps?: IPopoverProps; } @polyfill export class Breadcrumbs extends AbstractPureComponent2 { public static defaultProps: Partial = { collapseFrom: Boundary.START, }; public render() { const { className, collapseFrom, items, minVisibleItems, overflowListProps = {} } = this.props; return ( ); } private renderOverflow = (items: BreadcrumbProps[]) => { const { collapseFrom } = this.props; const position = collapseFrom === Boundary.END ? Position.BOTTOM_RIGHT : Position.BOTTOM_LEFT; let orderedItems = items; if (collapseFrom === Boundary.START) { // If we're collapsing from the start, the menu should be read from the bottom to the // top, continuing with the breadcrumbs to the right. Since this means the first // breadcrumb in the props must be the last in the menu, we need to reverse the overlow // order. orderedItems = items.slice().reverse(); } /* eslint-disable deprecation/deprecation */ return (
  • {orderedItems.map(this.renderOverflowBreadcrumb)}} {...this.props.popoverProps} >
  • ); /* eslint-enable deprecation/deprecation */ }; private renderOverflowBreadcrumb = (props: BreadcrumbProps, index: number) => { const isClickable = props.href != null || props.onClick != null; const htmlProps = removeNonHTMLProps(props); return ; }; private renderBreadcrumbWrapper = (props: BreadcrumbProps, index: number) => { const isCurrent = this.props.items[this.props.items.length - 1] === props; return
  • {this.renderBreadcrumb(props, isCurrent)}
  • ; }; private renderBreadcrumb(props: BreadcrumbProps, isCurrent: boolean) { if (isCurrent && this.props.currentBreadcrumbRenderer != null) { return this.props.currentBreadcrumbRenderer(props); } else if (this.props.breadcrumbRenderer != null) { return this.props.breadcrumbRenderer(props); } else { // allow user to override 'current' prop return ; } } }