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: false });
 156                 if (items.length) this.initializeCheckedList(items);
 157                 else this.setState({ checkedList: {} });
 158             }
 159             if (prevState.checkedList !== checkedList) {
 160                 toggleMSToolbar(this.isAnySelected() ? true : false);
 161                 setCheckedListOnStore(checkedList);
 162             }
 163         }
 164
 165         checkBoxColumn: DataColumn<any, any> = {
 166             name: 'checkBoxColumn',
 167             selected: true,
 168             configurable: false,
 169             filters: createTree(),
 170             render: (uuid) => (
 171                 <input
 172                     type='checkbox'
 173                     name={uuid}
 174                     className={this.props.classes.checkBox}
 175                     checked={this.state.checkedList[uuid] ?? false}
 176                     onChange={() => this.handleCheck(uuid)}
 177                     onDoubleClick={(ev) => ev.stopPropagation()}
 178                 ></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 = (): 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.isAllSelected(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 icon={PendingIcon} messages={['Loading data, please wait.']} />
 277                             </div>
 278                         )}
 279                         {items.length === 0 && !working && this.renderNoItemsPlaceholder(this.props.columns)}
 280                     </div>
 281                 </div>
 282             );
 283         }
 284
 285         renderNoItemsPlaceholder = (columns: DataColumns<T, any>) => {
 286             const dirty = columns.some((column) => getTreeDirty('')(column.filters));
 287             return <DataTableDefaultView icon={this.props.defaultViewIcon} messages={this.props.defaultViewMessages} filtersApplied={dirty} />;
 288         };
 289
 290         renderHeadCell = (column: DataColumn<T, any>, index: number) => {
 291             const { name, key, renderHeader, filters, sort } = column;
 292             const { onSortToggle, onFiltersChange, classes } = this.props;
 293             const { isSelected, checkedList } = this.state;
 294             return column.name === 'checkBoxColumn' ? (
 295                 <TableCell key={key || index} className={classes.checkBoxCell}>
 296                     <div className={classes.checkBoxHead}>
 297                         <Tooltip title={this.state.isSelected ? 'Deselect All' : 'Select All'}>
 298                             <input
 299                                 type='checkbox'
 300                                 className={classes.checkBox}
 301                                 checked={isSelected}
 302                                 disabled={!this.props.items.length}
 303                                 onChange={this.handleSelectorSelect}
 304                             ></input>
 305                         </Tooltip>
 306                         <DataTableMultiselectPopover
 307                             name={`Options`}
 308                             disabled={!this.props.items.length}
 309                             options={this.multiselectOptions}
 310                             checkedList={checkedList}
 311                         ></DataTableMultiselectPopover>
 312                     </div>
 313                 </TableCell>
 314             ) : (
 315                 <TableCell className={index == 1 ? classes.firstTableCell : classes.tableCell} key={key || index}>
 316                     {renderHeader ? (
 317                         renderHeader()
 318                     ) : countNodes(filters) > 0 ? (
 319                         <DataTableFiltersPopover
 320                             name={`${name} filters`}
 321                             mutuallyExclusive={column.mutuallyExclusiveFilters}
 322                             onChange={(filters) => onFiltersChange && onFiltersChange(filters, column)}
 323                             filters={filters}
 324                         >
 325                             {name}
 326                         </DataTableFiltersPopover>
 327                     ) : sort ? (
 328                         <TableSortLabel
 329                             active={sort.direction !== SortDirection.NONE}
 330                             direction={sort.direction !== SortDirection.NONE ? sort.direction : undefined}
 331                             IconComponent={this.ArrowIcon}
 332                             hideSortIcon
 333                             onClick={() => onSortToggle && onSortToggle(column)}
 334                         >
 335                             {name}
 336                         </TableSortLabel>
 337                     ) : (
 338                         <span>{name}</span>
 339                     )}
 340                 </TableCell>
 341             );
 342         };
 343
 344         ArrowIcon = ({ className, ...props }: SvgIconProps) => (
 345             <IconButton component='span' className={this.props.classes.arrowButton} tabIndex={-1}>
 346                 <ArrowDownwardIcon {...props} className={classnames(className, this.props.classes.arrow)} />
 347             </IconButton>
 348         );
 349
 350         renderBodyRow = (item: any, index: number) => {
 351             const { onRowClick, onRowDoubleClick, extractKey, classes, currentItemUuid, currentRoute } = this.props;
 352             return (
 353                 <TableRow
 354                     hover
 355                     key={extractKey ? extractKey(item) : index}
 356                     onClick={(event) => onRowClick && onRowClick(event, item)}
 357                     onContextMenu={this.handleRowContextMenu(item)}
 358                     onDoubleClick={(event) => onRowDoubleClick && onRowDoubleClick(event, item)}
 359                     selected={item === currentItemUuid}
 360                 >
 361                     {this.mapVisibleColumns((column, index) => (
 362                         <TableCell
 363                             key={column.key || index}
 364                             className={
 365                                 currentRoute === '/workflows'
 366                                     ? classes.tableCellWorkflows
 367                                     : index === 0
 368                                     ? classes.checkBoxCell
 369                                     : `${classes.tableCell} ${index === 1 ? classes.firstTableCell : ''}`
 370                             }
 371                         >
 372                             {column.render(item)}
 373                         </TableCell>
 374                     ))}
 375                 </TableRow>
 376             );
 377         };
 378
 379         mapVisibleColumns = (fn: (column: DataColumn<T, any>, index: number) => React.ReactElement<any>) => {
 380             return this.props.columns.filter((column) => column.selected).map(fn);
 381         };
 382
 383         handleRowContextMenu = (item: T) => (event: React.MouseEvent<HTMLElement>) => this.props.onContextMenu(event, item);
 384     }
 385 );