src/components/data-table/data-table.tsx

   1 // Copyright (C) The Arvados Authors. All rights reserved.
   2 //
   3 // SPDX-License-Identifier: AGPL-3.0
   4
   5 import React from "react";
   6 import {
   7     Table,
   8     TableBody,
   9     TableRow,
  10     TableCell,
  11     TableHead,
  12     TableSortLabel,
  13     StyleRulesCallback,
  14     Theme,
  15     WithStyles,
  16     withStyles,
  17     IconButton,
  18     Tooltip,
  19 } from "@material-ui/core";
  20 import classnames from "classnames";
  21 import { DataColumn, SortDirection } from "./data-column";
  22 import { DataTableDefaultView } from "../data-table-default-view/data-table-default-view";
  23 import { DataTableFilters } from "../data-table-filters/data-table-filters-tree";
  24 import { DataTableMultiselectPopover } from "../data-table-multiselect-popover/data-table-multiselect-popover";
  25 import { DataTableFiltersPopover } from "../data-table-filters/data-table-filters-popover";
  26 import { countNodes, getTreeDirty } from "models/tree";
  27 import { IconType, PendingIcon } from "components/icon/icon";
  28 import { SvgIconProps } from "@material-ui/core/SvgIcon";
  29 import ArrowDownwardIcon from "@material-ui/icons/ArrowDownward";
  30 import { createTree } from "models/tree";
  31 import { DataTableMultiselectOption } from "../data-table-multiselect-popover/data-table-multiselect-popover";
  32
  33 export type DataColumns<I, R> = Array<DataColumn<I, R>>;
  34
  35 export enum DataTableFetchMode {
  36     PAGINATED,
  37     INFINITE,
  38 }
  39
  40 export interface DataTableDataProps<I> {
  41     items: I[];
  42     columns: DataColumns<I, any>;
  43     onRowClick: (event: React.MouseEvent<HTMLTableRowElement>, item: I) => void;
  44     onContextMenu: (event: React.MouseEvent<HTMLElement>, item: I) => void;
  45     onRowDoubleClick: (event: React.MouseEvent<HTMLTableRowElement>, item: I) => void;
  46     onSortToggle: (column: DataColumn<I, any>) => void;
  47     onFiltersChange: (filters: DataTableFilters, column: DataColumn<I, any>) => void;
  48     extractKey?: (item: I) => React.Key;
  49     working?: boolean;
  50     defaultViewIcon?: IconType;
  51     defaultViewMessages?: string[];
  52     currentItemUuid?: string;
  53     currentRoute?: string;
  54     toggleMSToolbar: (isVisible: boolean) => void;
  55     setCheckedListOnStore: (checkedList: TCheckedList) => void;
  56 }
  57
  58 type CssRules =
  59     | "tableBody"
  60     | "root"
  61     | "content"
  62     | "noItemsInfo"
  63     | "checkBoxHead"
  64     | "checkBoxCell"
  65     | "checkBox"
  66     | "firstTableCell"
  67     | "tableCell"
  68     | "arrow"
  69     | "arrowButton"
  70     | "tableCellWorkflows"
  71     | "loader";
  72
  73 const styles: StyleRulesCallback<CssRules> = (theme: Theme) => ({
  74     root: {
  75         width: "100%",
  76     },
  77     content: {
  78         display: "inline-block",
  79         width: "100%",
  80     },
  81     tableBody: {
  82         background: theme.palette.background.paper,
  83     },
  84     loader: {
  85         left: "50%",
  86         marginLeft: "-84px",
  87         position: "absolute",
  88     },
  89     noItemsInfo: {
  90         textAlign: "center",
  91         padding: theme.spacing.unit,
  92     },
  93     checkBoxHead: {
  94         padding: "0",
  95         display: "flex",
  96     },
  97     checkBoxCell: {
  98         padding: "0",
  99         paddingLeft: "10px",
 100     },
 101     checkBox: {
 102         cursor: "pointer",
 103     },
 104     tableCell: {
 105         wordWrap: "break-word",
 106         paddingRight: "24px",
 107         color: "#737373",
 108     },
 109     firstTableCell: {
 110         paddingLeft: "5px",
 111     },
 112     tableCellWorkflows: {
 113         "&:nth-last-child(2)": {
 114             padding: "0px",
 115             maxWidth: "48px",
 116         },
 117         "&:last-child": {
 118             padding: "0px",
 119             paddingRight: "24px",
 120             width: "48px",
 121         },
 122     },
 123     arrow: {
 124         margin: 0,
 125     },
 126     arrowButton: {
 127         color: theme.palette.text.primary,
 128     },
 129 });
 130
 131 export type TCheckedList = Record<string, boolean>;
 132
 133 type DataTableState = {
 134     isSelected: boolean;
 135     checkedList: TCheckedList;
 136 };
 137
 138 type DataTableProps<T> = DataTableDataProps<T> & WithStyles<CssRules>;
 139
 140 export const DataTable = withStyles(styles)(
 141     class Component<T> extends React.Component<DataTableProps<T>> {
 142         state: DataTableState = {
 143             isSelected: false,
 144             checkedList: {},
 145         };
 146
 147         componentDidMount(): void {
 148             this.initializeCheckedList(this.props.items);
 149         }
 150
 151         componentDidUpdate(prevProps: Readonly<DataTableProps<T>>, prevState: DataTableState) {
 152             const { items, toggleMSToolbar, setCheckedListOnStore } = this.props;
 153             const { isSelected, checkedList } = this.state;
 154             if (prevProps.items !== items) {
 155                 if (isSelected === true) this.setState({ isSelected: this.isAnySelected(checkedList) });
 156
 157                 if (items.length) this.initializeCheckedList(items);
 158                 else this.setState({ checkedList: {} });
 159             }
 160             if (prevState.checkedList !== checkedList) {
 161                 toggleMSToolbar(this.isAnySelected(checkedList) ? true : false);
 162                 setCheckedListOnStore(checkedList);
 163             }
 164         }
 165
 166         checkBoxColumn: DataColumn<any, any> = {
 167             name: "checkBoxColumn",
 168             selected: true,
 169             configurable: false,
 170             filters: createTree(),
 171             render: uuid => (
 172                 <input
 173                     type="checkbox"
 174                     name={uuid}
 175                     className={this.props.classes.checkBox}
 176                     checked={this.state.checkedList[uuid] ?? false}
 177                     onChange={() => this.handleCheck(uuid)}
 178                     onDoubleClick={ev => ev.stopPropagation()}></input>
 179             ),
 180         };
 181
 182         multiselectOptions: DataTableMultiselectOption[] = [
 183             { name: "All", fn: list => this.handleSelectAll(list) },
 184             { name: "None", fn: list => this.handleSelectNone(list) },
 185             { name: "Invert", fn: list => this.handleInvertSelect(list) },
 186         ];
 187
 188         initializeCheckedList = (uuids: any[]): void => {
 189             const newCheckedList = { ...this.state.checkedList };
 190
 191             uuids.forEach(uuid => {
 192                 if (!newCheckedList.hasOwnProperty(uuid)) {
 193                     newCheckedList[uuid] = false;
 194                 }
 195             });
 196             for (const key in newCheckedList) {
 197                 if (!uuids.includes(key)) {
 198                     delete newCheckedList[key];
 199                 }
 200             }
 201             this.setState({ checkedList: newCheckedList });
 202         };
 203
 204         isAllSelected = (list: TCheckedList): boolean => {
 205             for (const key in list) {
 206                 if (list[key] === false) return false;
 207             }
 208             return true;
 209         };
 210
 211         isAnySelected = (checkedList): boolean => {
 212             // const { checkedList } = this.state;
 213             if (!Object.keys(checkedList).length) return false;
 214             for (const key in checkedList) {
 215                 if (checkedList[key] === true) return true;
 216             }
 217             return false;
 218         };
 219
 220         handleCheck = (uuid: string): void => {
 221             const { checkedList } = this.state;
 222             const newCheckedList = { ...checkedList };
 223             newCheckedList[uuid] = !checkedList[uuid];
 224             this.setState({ checkedList: newCheckedList, isSelected: this.isAnySelected(newCheckedList) });
 225         };
 226
 227         handleSelectorSelect = (): void => {
 228             const { checkedList } = this.state;
 229             const { isSelected } = this.state;
 230             isSelected ? this.handleSelectNone(checkedList) : this.handleSelectAll(checkedList);
 231         };
 232
 233         handleSelectAll = (list: TCheckedList): void => {
 234             if (Object.keys(list).length) {
 235                 const newCheckedList = { ...list };
 236                 for (const key in newCheckedList) {
 237                     newCheckedList[key] = true;
 238                 }
 239                 this.setState({ isSelected: true, checkedList: newCheckedList });
 240             }
 241         };
 242
 243         handleSelectNone = (list: TCheckedList): void => {
 244             const newCheckedList = { ...list };
 245             for (const key in newCheckedList) {
 246                 newCheckedList[key] = false;
 247             }
 248             this.setState({ isSelected: false, checkedList: newCheckedList });
 249         };
 250
 251         handleInvertSelect = (list: TCheckedList): void => {
 252             if (Object.keys(list).length) {
 253                 const newCheckedList = { ...list };
 254                 for (const key in newCheckedList) {
 255                     newCheckedList[key] = !list[key];
 256                 }
 257                 this.setState({ checkedList: newCheckedList, isSelected: this.isAllSelected(newCheckedList) });
 258             }
 259         };
 260
 261         render() {
 262             const { items, classes, working, columns } = this.props;
 263             if (columns[0].name === this.checkBoxColumn.name) columns.shift();
 264             columns.unshift(this.checkBoxColumn);
 265             return (
 266                 <div className={classes.root}>
 267                     <div className={classes.content}>
 268                         <Table>
 269                             <TableHead>
 270                                 <TableRow>{this.mapVisibleColumns(this.renderHeadCell)}</TableRow>
 271                             </TableHead>
 272                             <TableBody className={classes.tableBody}>{!working && items.map(this.renderBodyRow)}</TableBody>
 273                         </Table>
 274                         {!!working && (
 275                             <div className={classes.loader}>
 276                                 <DataTableDefaultView
 277                                     icon={PendingIcon}
 278                                     messages={["Loading data, please wait."]}
 279                                 />
 280                             </div>
 281                         )}
 282                         {items.length === 0 && !working && this.renderNoItemsPlaceholder(this.props.columns)}
 283                     </div>
 284                 </div>
 285             );
 286         }
 287
 288         renderNoItemsPlaceholder = (columns: DataColumns<T, any>) => {
 289             const dirty = columns.some(column => getTreeDirty("")(column.filters));
 290             return (
 291                 <DataTableDefaultView
 292                     icon={this.props.defaultViewIcon}
 293                     messages={this.props.defaultViewMessages}
 294                     filtersApplied={dirty}
 295                 />
 296             );
 297         };
 298
 299         renderHeadCell = (column: DataColumn<T, any>, index: number) => {
 300             const { name, key, renderHeader, filters, sort } = column;
 301             const { onSortToggle, onFiltersChange, classes } = this.props;
 302             const { isSelected, checkedList } = this.state;
 303             return column.name === "checkBoxColumn" ? (
 304                 <TableCell
 305                     key={key || index}
 306                     className={classes.checkBoxCell}>
 307                     <div className={classes.checkBoxHead}>
 308                         <Tooltip title={this.state.isSelected ? "Deselect All" : "Select All"}>
 309                             <input
 310                                 type="checkbox"
 311                                 className={classes.checkBox}
 312                                 checked={isSelected}
 313                                 disabled={!this.props.items.length}
 314                                 onChange={this.handleSelectorSelect}></input>
 315                         </Tooltip>
 316                         <DataTableMultiselectPopover
 317                             name={`Options`}
 318                             disabled={!this.props.items.length}
 319                             options={this.multiselectOptions}
 320                             checkedList={checkedList}></DataTableMultiselectPopover>
 321                     </div>
 322                 </TableCell>
 323             ) : (
 324                 <TableCell
 325                     className={index == 1 ? classes.firstTableCell : classes.tableCell}
 326                     key={key || index}>
 327                     {renderHeader ? (
 328                         renderHeader()
 329                     ) : countNodes(filters) > 0 ? (
 330                         <DataTableFiltersPopover
 331                             name={`${name} filters`}
 332                             mutuallyExclusive={column.mutuallyExclusiveFilters}
 333                             onChange={filters => onFiltersChange && onFiltersChange(filters, column)}
 334                             filters={filters}>
 335                             {name}
 336                         </DataTableFiltersPopover>
 337                     ) : sort ? (
 338                         <TableSortLabel
 339                             active={sort.direction !== SortDirection.NONE}
 340                             direction={sort.direction !== SortDirection.NONE ? sort.direction : undefined}
 341                             IconComponent={this.ArrowIcon}
 342                             hideSortIcon
 343                             onClick={() => onSortToggle && onSortToggle(column)}>
 344                             {name}
 345                         </TableSortLabel>
 346                     ) : (
 347                         <span>{name}</span>
 348                     )}
 349                 </TableCell>
 350             );
 351         };
 352
 353         ArrowIcon = ({ className, ...props }: SvgIconProps) => (
 354             <IconButton
 355                 component="span"
 356                 className={this.props.classes.arrowButton}
 357                 tabIndex={-1}>
 358                 <ArrowDownwardIcon
 359                     {...props}
 360                     className={classnames(className, this.props.classes.arrow)}
 361                 />
 362             </IconButton>
 363         );
 364
 365         renderBodyRow = (item: any, index: number) => {
 366             const { onRowClick, onRowDoubleClick, extractKey, classes, currentItemUuid, currentRoute } = this.props;
 367             return (
 368                 <TableRow
 369                     hover
 370                     key={extractKey ? extractKey(item) : index}
 371                     onClick={event => onRowClick && onRowClick(event, item)}
 372                     onContextMenu={this.handleRowContextMenu(item)}
 373                     onDoubleClick={event => onRowDoubleClick && onRowDoubleClick(event, item)}
 374                     selected={item === currentItemUuid}>
 375                     {this.mapVisibleColumns((column, index) => (
 376                         <TableCell
 377                             key={column.key || index}
 378                             className={
 379                                 currentRoute === "/workflows"
 380                                     ? classes.tableCellWorkflows
 381                                     : index === 0
 382                                     ? classes.checkBoxCell
 383                                     : `${classes.tableCell} ${index === 1 ? classes.firstTableCell : ""}`
 384                             }>
 385                             {column.render(item)}
 386                         </TableCell>
 387                     ))}
 388                 </TableRow>
 389             );
 390         };
 391
 392         mapVisibleColumns = (fn: (column: DataColumn<T, any>, index: number) => React.ReactElement<any>) => {
 393             return this.props.columns.filter(column => column.selected).map(fn);
 394         };
 395
 396         handleRowContextMenu = (item: T) => (event: React.MouseEvent<HTMLElement>) => this.props.onContextMenu(event, item);
 397     }
 398 );