1 // Copyright (C) The Arvados Authors. All rights reserved.
3 // SPDX-License-Identifier: AGPL-3.0
5 import * as React from 'react';
6 import { List, ListItem, ListItemIcon, Collapse, Checkbox, Radio } from "@material-ui/core";
7 import { StyleRulesCallback, withStyles, WithStyles } from '@material-ui/core/styles';
8 import { ReactElement } from "react";
9 import CircularProgress from '@material-ui/core/CircularProgress';
10 import * as classnames from "classnames";
12 import { ArvadosTheme } from '~/common/custom-theme';
13 import { SidePanelRightArrowIcon } from '../icon/icon';
15 type CssRules = 'list'
19 | 'toggableIconContainer'
26 const styles: StyleRulesCallback<CssRules> = (theme: ArvadosTheme) => ({
35 transform: 'translate(0px)',
38 toggableIconContainer: {
39 color: theme.palette.grey["700"],
50 color: theme.palette.primary.main,
53 transition: 'all 0.1s ease',
56 transition: 'all 0.1s ease',
57 transform: 'rotate(90deg)',
60 width: theme.spacing.unit * 3,
61 height: theme.spacing.unit * 3,
62 margin: `0 ${theme.spacing.unit}px`,
64 color: theme.palette.grey["500"],
68 export enum TreeItemStatus {
74 export interface TreeItem<T> {
80 status: TreeItemStatus;
81 items?: Array<TreeItem<T>>;
84 export interface TreeProps<T> {
85 disableRipple?: boolean;
86 currentItemUuid?: string;
87 items?: Array<TreeItem<T>>;
89 onContextMenu: (event: React.MouseEvent<HTMLElement>, item: TreeItem<T>) => void;
90 render: (item: TreeItem<T>, level?: number) => ReactElement<{}>;
91 showSelection?: boolean | ((item: TreeItem<T>) => boolean);
92 levelIndentation?: number;
93 itemRightPadding?: number;
94 toggleItemActive: (event: React.MouseEvent<HTMLElement>, item: TreeItem<T>) => void;
95 toggleItemOpen: (event: React.MouseEvent<HTMLElement>, item: TreeItem<T>) => void;
96 toggleItemSelection?: (event: React.MouseEvent<HTMLElement>, item: TreeItem<T>) => void;
99 * When set to true use radio buttons instead of checkboxes for item selection.
100 * This does not guarantee radio group behavior (i.e item mutual exclusivity).
101 * Any item selection logic must be done in the toggleItemActive callback prop.
103 useRadioButtons?: boolean;
106 export const Tree = withStyles(styles)(
107 class Component<T> extends React.Component<TreeProps<T> & WithStyles<CssRules>, {}> {
108 render(): ReactElement<any> {
109 const level = this.props.level ? this.props.level : 0;
110 const { classes, render, toggleItemOpen, items, toggleItemActive, onContextMenu, disableRipple, currentItemUuid, useRadioButtons } = this.props;
111 const { list, listItem, loader, toggableIconContainer, renderContainer } = classes;
112 const showSelection = typeof this.props.showSelection === 'function'
113 ? this.props.showSelection
114 : () => this.props.showSelection ? true : false;
116 const { levelIndentation = 20, itemRightPadding = 20 } = this.props;
118 return <List className={list}>
119 {items && items.map((it: TreeItem<T>, idx: number) =>
120 <div key={`item/${level}/${idx}`}>
121 <ListItem button className={listItem}
123 paddingLeft: (level + 1) * levelIndentation,
124 paddingRight: itemRightPadding,
126 disableRipple={disableRipple}
127 onClick={event => toggleItemActive(event, it)}
128 selected={showSelection(it) && it.id === currentItemUuid}
129 onContextMenu={this.handleRowContextMenu(it)}>
130 {it.status === TreeItemStatus.PENDING ?
131 <CircularProgress size={10} className={loader} /> : null}
132 <i onClick={this.handleToggleItemOpen(it)}
133 className={toggableIconContainer}>
134 <ListItemIcon className={this.getToggableIconClassNames(it.open, it.active)}>
135 {this.getProperArrowAnimation(it.status, it.items!)}
138 {showSelection(it) && !useRadioButtons &&
140 checked={it.selected}
141 className={classes.checkbox}
143 onClick={this.handleCheckboxChange(it)} />}
144 {showSelection(it) && useRadioButtons &&
146 checked={it.selected}
147 className={classes.checkbox}
149 <div className={renderContainer}>
153 {it.items && it.items.length > 0 &&
154 <Collapse in={it.open} timeout="auto" unmountOnExit>
156 showSelection={this.props.showSelection}
159 disableRipple={disableRipple}
160 toggleItemOpen={toggleItemOpen}
161 toggleItemActive={toggleItemActive}
163 onContextMenu={onContextMenu}
164 toggleItemSelection={this.props.toggleItemSelection} />
170 getProperArrowAnimation = (status: string, items: Array<TreeItem<T>>) => {
171 return this.isSidePanelIconNotNeeded(status, items) ? <span /> : <SidePanelRightArrowIcon style={{ fontSize: '14px' }} />;
174 isSidePanelIconNotNeeded = (status: string, items: Array<TreeItem<T>>) => {
175 return status === TreeItemStatus.PENDING ||
176 (status === TreeItemStatus.LOADED && !items) ||
177 (status === TreeItemStatus.LOADED && items && items.length === 0);
180 getToggableIconClassNames = (isOpen?: boolean, isActive?: boolean) => {
181 const { iconOpen, iconClose, active, toggableIcon } = this.props.classes;
182 return classnames(toggableIcon, {
184 [iconClose]: !isOpen,
189 handleRowContextMenu = (item: TreeItem<T>) =>
190 (event: React.MouseEvent<HTMLElement>) =>
191 this.props.onContextMenu(event, item)
193 handleCheckboxChange = (item: TreeItem<T>) => {
194 const { toggleItemSelection } = this.props;
195 return toggleItemSelection
196 ? (event: React.MouseEvent<HTMLElement>) => {
197 event.stopPropagation();
198 toggleItemSelection(event, item);
203 handleToggleItemOpen = (item: TreeItem<T>) => (event: React.MouseEvent<HTMLElement>) => {
204 event.stopPropagation();
205 this.props.toggleItemOpen(event, item);