/** * Copyright (c) Facebook, Inc. and its affiliates. * * This source code is licensed under the MIT license found in the * LICENSE file in the root directory of this source tree. * * @format */ import React, { useCallback, useLayoutEffect, useMemo, useRef, useState, RefObject, MutableRefObject, CSSProperties, useEffect, useReducer, } from 'react'; import {TableRow, DEFAULT_ROW_HEIGHT} from './TableRow'; import {Layout} from '../Layout'; import {TableHead} from './TableHead'; import {Percentage} from '../../utils/widthUtils'; import { DataSourceRendererVirtual, DataSourceRendererStatic, DataSource, DataSourceVirtualizer, } from '../../data-source/index'; import { computeDataTableFilter, createDataTableManager, createInitialState, DataTableManager, dataTableManagerReducer, DataTableReducer, getSelectedItem, getSelectedItems, savePreferences, } from './DataTableManager'; import {TableSearch} from './TableSearch'; import styled from '@emotion/styled'; import {theme} from '../theme'; import {tableContextMenuFactory} from './TableContextMenu'; import {Typography} from 'antd'; import {CoffeeOutlined, SearchOutlined, PushpinFilled} from '@ant-design/icons'; import {useAssertStableRef} from '../../utils/useAssertStableRef'; import {Formatter} from '../DataFormatter'; import {usePluginInstanceMaybe} from '../../plugin/PluginContext'; import {debounce} from 'lodash'; import {useInUnitTest} from '../../utils/useInUnitTest'; import {createDataSource} from '../../state/createDataSource'; interface DataTableBaseProps { columns: DataTableColumn[]; enableSearchbar?: boolean; enableAutoScroll?: boolean; enableColumnHeaders?: boolean; enableMultiSelect?: boolean; enableContextMenu?: boolean; enablePersistSettings?: boolean; // if set (the default) will grow and become scrollable. Otherwise will use natural size scrollable?: boolean; extraActions?: React.ReactElement; onSelect?(record: T | undefined, records: T[]): void; onRowStyle?(record: T): CSSProperties | undefined; tableManagerRef?: RefObject | undefined>; // Actually we want a MutableRefObject, but that is not what React.createRef() returns, and we don't want to put the burden on the plugin dev to cast it... onCopyRows?(records: T[]): string; onContextMenu?: (selection: undefined | T) => React.ReactElement; onRenderEmpty?: | null | ((dataSource?: DataSource) => React.ReactElement); } export type ItemRenderer = ( item: T, selected: boolean, index: number, ) => React.ReactNode; type DataTableInput = | { dataSource: DataSource; records?: undefined; recordsKey?: undefined; } | { records: readonly T[]; recordsKey?: keyof T; dataSource?: undefined; }; export type DataTableColumn = { key: keyof T & string; // possible future extension: getValue(row) (and free-form key) to support computed columns onRender?: (row: T, selected: boolean, index: number) => React.ReactNode; formatters?: Formatter[] | Formatter; title?: string; width?: number | Percentage | undefined; // undefined: use all remaining width wrap?: boolean; align?: 'left' | 'right' | 'center'; visible?: boolean; filters?: { label: string; value: string; enabled: boolean; predefined?: boolean; }[]; inversed?: boolean; }; export interface TableRowRenderContext { columns: DataTableColumn[]; onMouseEnter( e: React.MouseEvent, item: T, itemId: number, ): void; onMouseDown( e: React.MouseEvent, item: T, itemId: number, ): void; onRowStyle?(item: T): React.CSSProperties | undefined; onContextMenu?(): React.ReactElement; } export type DataTableProps = DataTableInput & DataTableBaseProps; export function DataTable( props: DataTableProps, ): React.ReactElement { const {onRowStyle, onSelect, onCopyRows, onContextMenu} = props; const dataSource = normalizeDataSourceInput(props); useAssertStableRef(dataSource, 'dataSource'); useAssertStableRef(onRowStyle, 'onRowStyle'); useAssertStableRef(props.onSelect, 'onRowSelect'); useAssertStableRef(props.columns, 'columns'); useAssertStableRef(onCopyRows, 'onCopyRows'); useAssertStableRef(onContextMenu, 'onContextMenu'); const isUnitTest = useInUnitTest(); // eslint-disable-next-line const scope = isUnitTest ? '' : usePluginInstanceMaybe()?.pluginKey ?? ''; const virtualizerRef = useRef(); const [tableState, dispatch] = useReducer( dataTableManagerReducer as DataTableReducer, undefined, () => createInitialState({ dataSource, defaultColumns: props.columns, onSelect, scope, virtualizerRef, autoScroll: props.enableAutoScroll, enablePersistSettings: props.enablePersistSettings, }), ); const stateRef = useRef(tableState); stateRef.current = tableState; const lastOffset = useRef(0); const dragging = useRef(false); const [tableManager] = useState(() => createDataTableManager(dataSource, dispatch, stateRef), ); if (props.tableManagerRef) { (props.tableManagerRef as MutableRefObject).current = tableManager; } const {columns, selection, searchValue, sorting} = tableState; const visibleColumns = useMemo( () => columns.filter((column) => column.visible), [columns], ); const renderingConfig = useMemo>(() => { let startIndex = 0; return { columns: visibleColumns, onMouseEnter(e, _item, index) { if (dragging.current && e.buttons === 1 && props.enableMultiSelect) { // by computing range we make sure no intermediate items are missed when scrolling fast tableManager.addRangeToSelection(startIndex, index); } }, onMouseDown(e, _item, index) { if (!props.enableMultiSelect && e.buttons > 1) { tableManager.selectItem(index, false, true); return; } if (!dragging.current) { if (e.buttons > 1) { // for right click we only want to add if needed, not deselect tableManager.addRangeToSelection(index, index, false); } else if (e.ctrlKey || e.metaKey) { tableManager.addRangeToSelection(index, index, true); } else if (e.shiftKey) { tableManager.selectItem(index, true, true); } else { tableManager.selectItem(index, false, true); } dragging.current = true; startIndex = index; function onStopDragSelecting() { dragging.current = false; document.removeEventListener('mouseup', onStopDragSelecting); } document.addEventListener('mouseup', onStopDragSelecting); } }, onRowStyle, onContextMenu: props.enableContextMenu ? () => { // using a ref keeps the config stable, so that a new context menu doesn't need // all rows to be rerendered, but rather shows it conditionally return contextMenuRef.current?.()!; } : undefined, }; }, [ visibleColumns, tableManager, onRowStyle, props.enableContextMenu, props.enableMultiSelect, ]); const itemRenderer = useCallback( function itemRenderer( record: T, index: number, renderContext: TableRowRenderContext, ) { return ( ); }, [selection, onRowStyle], ); /** * Keyboard / selection handling */ const onKeyDown = useCallback( (e: React.KeyboardEvent) => { let handled = true; const shiftPressed = e.shiftKey; const outputSize = dataSource.view.size; const windowSize = props.scrollable ? virtualizerRef.current?.virtualItems.length ?? 0 : dataSource.view.size; if (!windowSize) { return; } switch (e.key) { case 'ArrowUp': tableManager.selectItem( (idx) => (idx > 0 ? idx - 1 : 0), shiftPressed, ); break; case 'ArrowDown': tableManager.selectItem( (idx) => (idx < outputSize - 1 ? idx + 1 : idx), shiftPressed, ); break; case 'Home': tableManager.selectItem(0, shiftPressed); break; case 'End': tableManager.selectItem(outputSize - 1, shiftPressed); break; case ' ': // yes, that is a space case 'PageDown': tableManager.selectItem( (idx) => Math.min(outputSize - 1, idx + windowSize - 1), shiftPressed, ); break; case 'PageUp': tableManager.selectItem( (idx) => Math.max(0, idx - windowSize + 1), shiftPressed, ); break; case 'Escape': tableManager.clearSelection(); break; default: handled = false; } if (handled) { e.stopPropagation(); e.preventDefault(); } }, [dataSource, tableManager, props.scrollable], ); const [debouncedSetFilter] = useState(() => { // we don't want to trigger filter changes too quickly, as they can be pretty expensive // and would block the user from entering text in the search bar for example // (and in the future would really benefit from concurrent mode here :)) const setFilter = ( search: string, useRegex: boolean, columns: DataTableColumn[], ) => { dataSource.view.setFilter( computeDataTableFilter(search, useRegex, columns), ); }; return isUnitTest ? setFilter : debounce(setFilter, 250); }); useEffect( function updateFilter() { debouncedSetFilter( tableState.searchValue, tableState.useRegex, tableState.columns, ); }, // Important dep optimization: we don't want to recalc filters if just the width or visibility changes! // We pass entire state.columns to computeDataTableFilter, but only changes in the filter are a valid cause to compute a new filter function // eslint-disable-next-line [ tableState.searchValue, tableState.useRegex, ...tableState.columns.map((c) => c.filters), ...tableState.columns.map((c) => c.inversed), ], ); useEffect( function updateSorting() { if (tableState.sorting === undefined) { dataSource.view.setSortBy(undefined); dataSource.view.setReversed(false); } else { dataSource.view.setSortBy(tableState.sorting.key); dataSource.view.setReversed(tableState.sorting.direction === 'desc'); } }, [dataSource, tableState.sorting], ); const isMounted = useRef(false); useEffect( function triggerSelection() { if (isMounted.current) { onSelect?.( getSelectedItem(dataSource, tableState.selection), getSelectedItems(dataSource, tableState.selection), ); } isMounted.current = true; }, [onSelect, dataSource, tableState.selection], ); // The initialScrollPosition is used to both capture the initial px we want to scroll to, // and whether we performed that scrolling already (if so, it will be 0) useLayoutEffect( function scrollSelectionIntoView() { if (tableState.initialOffset) { virtualizerRef.current?.scrollToOffset(tableState.initialOffset); dispatch({ type: 'appliedInitialScroll', }); } else if (selection && selection.current >= 0) { dispatch({type: 'setAutoScroll', autoScroll: false}); virtualizerRef.current?.scrollToIndex(selection!.current, { align: 'auto', }); } }, // initialOffset is relevant for the first run, // but should not trigger the efffect in general // eslint-disable-next-line [selection], ); /** Range finder */ const [range, setRange] = useState(''); const hideRange = useRef(); const onRangeChange = useCallback( (start: number, end: number, total: number, offset) => { setRange(`${start} - ${end} / ${total}`); lastOffset.current = offset; clearTimeout(hideRange.current!); hideRange.current = setTimeout(() => { setRange(''); }, 1000); }, [], ); const onUpdateAutoScroll = useCallback( (autoScroll: boolean) => { if (props.enableAutoScroll) { dispatch({type: 'setAutoScroll', autoScroll}); } }, [props.enableAutoScroll], ); /** Context menu */ const contexMenu = isUnitTest ? undefined : // eslint-disable-next-line useCallback( () => tableContextMenuFactory( dataSource, dispatch, selection, tableState.columns, visibleColumns, onCopyRows, onContextMenu, ), [ dataSource, dispatch, selection, tableState.columns, visibleColumns, onCopyRows, onContextMenu, ], ); const contextMenuRef = useRef(contexMenu); contextMenuRef.current = contexMenu; useEffect(function initialSetup() { return function cleanup() { // write current prefs to local storage savePreferences(stateRef.current, lastOffset.current); // if the component unmounts, we reset the SFRW pipeline to // avoid wasting resources in the background dataSource.view.reset(); // clean ref if (props.tableManagerRef) { (props.tableManagerRef as MutableRefObject).current = undefined; } }; // one-time setup and cleanup effect, everything in here is asserted to be stable: // dataSource, tableManager, tableManagerRef // eslint-disable-next-line }, []); const header = ( {props.enableSearchbar && ( )} {props.enableColumnHeaders && ( )} ); const emptyRenderer = props.onRenderEmpty === undefined ? props.onRenderEmpty : props.onRenderEmpty; const mainSection = props.scrollable ? ( {header} > dataSource={dataSource} autoScroll={tableState.autoScroll && !dragging.current} useFixedRowHeight={!tableState.usesWrapping} defaultRowHeight={DEFAULT_ROW_HEIGHT} context={renderingConfig} itemRenderer={itemRenderer} onKeyDown={onKeyDown} virtualizerRef={virtualizerRef} onRangeChange={onRangeChange} onUpdateAutoScroll={onUpdateAutoScroll} emptyRenderer={emptyRenderer} /> ) : ( {header} > dataSource={dataSource} useFixedRowHeight={!tableState.usesWrapping} defaultRowHeight={DEFAULT_ROW_HEIGHT} context={renderingConfig} itemRenderer={itemRenderer} onKeyDown={onKeyDown} emptyRenderer={emptyRenderer} /> ); return ( {mainSection} {props.enableAutoScroll && ( { dispatch({type: 'toggleAutoScroll'}); }} /> )} {range && !isUnitTest && {range}} ); } DataTable.defaultProps = { scrollable: true, enableSearchbar: true, enableAutoScroll: false, enableColumnHeaders: true, enableMultiSelect: true, enableContextMenu: true, onRenderEmpty: emptyRenderer, } as Partial>; /* eslint-disable react-hooks/rules-of-hooks */ function normalizeDataSourceInput( props: DataTableInput, ): DataSource { if (props.dataSource) { return props.dataSource; } if (props.records) { const [dataSource] = useState(() => createDataSource(props.records, {key: props.recordsKey}), ); useEffect(() => { syncRecordsToDataSource(dataSource, props.records); }, [dataSource, props.records]); return dataSource; } throw new Error( `Either the 'dataSource' or 'records' prop should be provided to DataTable`, ); } /* eslint-enable */ function syncRecordsToDataSource( ds: DataSource, records: readonly T[], ) { const startTime = Date.now(); ds.clear(); // TODO: optimize in the case we're only dealing with appends or replacements records.forEach((r) => ds.append(r)); const duration = Math.abs(Date.now() - startTime); if (duration > 50 || records.length > 500) { console.warn( "The 'records' props is only intended to be used on small datasets. Please use a 'dataSource' instead. See createDataSource for details: https://fbflipper.com/docs/extending/flipper-plugin#createdatasource", ); } } function emptyRenderer(dataSource: DataSource) { return ; } function EmptyTable({dataSource}: {dataSource: DataSource}) { return ( {dataSource.size === 0 ? ( <> No records yet ) : ( <> No records match the current search / filter criteria )} ); } const RangeFinder = styled.div({ backgroundColor: theme.backgroundWash, position: 'absolute', right: 64, bottom: 20, padding: '4px 8px', color: theme.textColorSecondary, fontSize: '0.8em', }); const AutoScroller = styled.div({ backgroundColor: theme.backgroundWash, position: 'absolute', right: 40, bottom: 20, width: 24, padding: '4px 8px', color: theme.textColorSecondary, fontSize: '0.8em', });