/** * Copyright (c) OpenLens Authors. All rights reserved. * Licensed under MIT License. See LICENSE in root directory for more information. */ import "./item-list-layout.scss"; import groupBy from "lodash/groupBy"; import React, { ReactNode } from "react"; import { computed, makeObservable } from "mobx"; import { observer } from "mobx-react"; import { ConfirmDialog, ConfirmDialogParams } from "../confirm-dialog"; import { Table, TableCell, TableCellProps, TableHead, TableProps, TableRow, TableRowProps, TableSortCallbacks } from "../table"; import { boundMethod, cssNames, IClassName, isReactNode, noop, ObservableToggleSet, prevDefault, stopPropagation, StorageHelper, } from "../../utils"; import { AddRemoveButtons, AddRemoveButtonsProps } from "../add-remove-buttons"; import { NoItems } from "../no-items"; import { Spinner } from "../spinner"; import type { ItemObject, ItemStore } from "../../../common/item.store"; import { SearchInputUrlProps, SearchInputUrl } from "../input"; import { Filter, FilterType, pageFilters } from "./page-filters.store"; import { PageFiltersList } from "./page-filters-list"; import { ThemeStore } from "../../theme.store"; import { MenuActions } from "../menu/menu-actions"; import { MenuItem } from "../menu"; import { Checkbox } from "../checkbox"; import { UserStore } from "../../../common/user-store"; import type { NamespaceStore } from "../+namespaces/namespace-store/namespace.store"; import namespaceStoreInjectable from "../+namespaces/namespace-store/namespace-store.injectable"; import { withInjectables } from "@ogre-tools/injectable-react"; import itemListLayoutStorageInjectable from "./item-list-layout-storage/item-list-layout-storage.injectable"; export type SearchFilter = (item: I) => string | number | (string | number)[]; export type SearchFilters = Record>; export type ItemsFilter = (items: I[]) => I[]; export type ItemsFilters = Record>; export interface HeaderPlaceholders { title?: ReactNode; searchProps?: SearchInputUrlProps; filters?: ReactNode; info?: ReactNode; } export type HeaderCustomizer = (placeholders: HeaderPlaceholders) => HeaderPlaceholders; export interface ItemListLayoutProps { tableId?: string; className: IClassName; items?: I[]; store: ItemStore; dependentStores?: ItemStore[]; preloadStores?: boolean; hideFilters?: boolean; searchFilters?: SearchFilter[]; /** @deprecated */ filterItems?: ItemsFilter[]; // header (title, filtering, searching, etc.) showHeader?: boolean; headerClassName?: IClassName; renderHeaderTitle?: ReactNode | ((parent: NonInjectedItemListLayout) => ReactNode); customizeHeader?: HeaderCustomizer | HeaderCustomizer[]; // items list configuration isReady?: boolean; // show loading indicator while not ready isSelectable?: boolean; // show checkbox in rows for selecting items isConfigurable?: boolean; copyClassNameFromHeadCells?: boolean; sortingCallbacks?: TableSortCallbacks; tableProps?: Partial>; // low-level table configuration renderTableHeader: TableCellProps[] | null; renderTableContents: (item: I) => (ReactNode | TableCellProps)[]; renderItemMenu?: (item: I, store: ItemStore) => ReactNode; customizeTableRowProps?: (item: I) => Partial; addRemoveButtons?: Partial; virtual?: boolean; // item details view hasDetailsView?: boolean; detailsItem?: I; onDetails?: (item: I) => void; // other customizeRemoveDialog?: (selectedItems: I[]) => Partial; renderFooter?: (parent: NonInjectedItemListLayout) => React.ReactNode; /** * Message to display when a store failed to load * * @default "Failed to load items" */ failedToLoadMessage?: React.ReactNode; filterCallbacks?: ItemsFilters; } const defaultProps: Partial> = { showHeader: true, isSelectable: true, isConfigurable: false, copyClassNameFromHeadCells: true, preloadStores: true, dependentStores: [], searchFilters: [], customizeHeader: [], filterItems: [], hasDetailsView: true, onDetails: noop, virtual: true, customizeTableRowProps: () => ({}), failedToLoadMessage: "Failed to load items", }; interface Dependencies { namespaceStore: NamespaceStore; itemListLayoutStorage: StorageHelper<{ showFilters: boolean }>; } @observer class NonInjectedItemListLayout extends React.Component & Dependencies> { static defaultProps = defaultProps as object; constructor(props: ItemListLayoutProps & Dependencies) { super(props); makeObservable(this); } get showFilters(): boolean { return this.props.itemListLayoutStorage.get().showFilters; } set showFilters(showFilters: boolean) { this.props.itemListLayoutStorage.merge({ showFilters }); } async componentDidMount() { const { isConfigurable, tableId, preloadStores } = this.props; if (isConfigurable && !tableId) { throw new Error("[ItemListLayout]: configurable list require props.tableId to be specified"); } if (isConfigurable && !UserStore.getInstance().hiddenTableColumns.has(tableId)) { UserStore.getInstance().hiddenTableColumns.set(tableId, new ObservableToggleSet()); } if (preloadStores) { this.loadStores(); } } private loadStores() { const { store, dependentStores } = this.props; const stores = Array.from(new Set([store, ...dependentStores])); stores.forEach(store => store.loadAll(this.props.namespaceStore.contextNamespaces)); } private filterCallbacks: ItemsFilters = { [FilterType.SEARCH]: items => { const { searchFilters } = this.props; const search = pageFilters.getValues(FilterType.SEARCH)[0] || ""; if (search && searchFilters.length) { const normalizeText = (text: string) => String(text).toLowerCase(); const searchTexts = [search].map(normalizeText); return items.filter(item => { return searchFilters.some(getTexts => { const sourceTexts: string[] = [getTexts(item)].flat().map(normalizeText); return sourceTexts.some(source => searchTexts.some(search => source.includes(search))); }); }); } return items; }, }; @computed get isReady() { return this.props.isReady ?? this.props.store.isLoaded; } @computed get failedToLoad() { return this.props.store.failedLoading; } @computed get filters() { let { activeFilters } = pageFilters; const { searchFilters } = this.props; if (searchFilters.length === 0) { activeFilters = activeFilters.filter(({ type }) => type !== FilterType.SEARCH); } return activeFilters; } applyFilters(filters: ItemsFilter[], items: I[]): I[] { if (!filters || !filters.length) return items; return filters.reduce((items, filter) => filter(items), items); } @computed get items() { const { filters, filterCallbacks, props } = this; const filterGroups = groupBy(filters, ({ type }) => type); const filterItems: ItemsFilter[] = []; Object.entries(filterGroups).forEach(([type, filtersGroup]) => { const filterCallback = filterCallbacks[type] ?? props.filterCallbacks?.[type]; if (filterCallback && filtersGroup.length > 0) { filterItems.push(filterCallback); } }); const items = this.props.items ?? this.props.store.items; return this.applyFilters(filterItems.concat(this.props.filterItems), items); } @boundMethod getRow(uid: string) { const { isSelectable, renderTableHeader, renderTableContents, renderItemMenu, store, hasDetailsView, onDetails, copyClassNameFromHeadCells, customizeTableRowProps, detailsItem, } = this.props; const { isSelected } = store; const item = this.items.find(item => item.getId() == uid); if (!item) return null; const itemId = item.getId(); return ( onDetails(item)) : undefined} {...customizeTableRowProps(item)} > {isSelectable && ( store.toggleSelection(item))} /> )} { renderTableContents(item).map((content, index) => { const cellProps: TableCellProps = isReactNode(content) ? { children: content } : content; const headCell = renderTableHeader?.[index]; if (copyClassNameFromHeadCells && headCell) { cellProps.className = cssNames(cellProps.className, headCell.className); } if (!headCell || this.showColumn(headCell)) { return ; } return null; }) } {renderItemMenu && (
{renderItemMenu(item, store)}
)}
); } @boundMethod removeItemsDialog() { const { customizeRemoveDialog, store } = this.props; const { selectedItems, removeSelectedItems } = store; const visibleMaxNamesCount = 5; const selectedNames = selectedItems.map(ns => ns.getName()).slice(0, visibleMaxNamesCount).join(", "); const dialogCustomProps = customizeRemoveDialog ? customizeRemoveDialog(selectedItems) : {}; const selectedCount = selectedItems.length; const tailCount = selectedCount > visibleMaxNamesCount ? selectedCount - visibleMaxNamesCount : 0; const tail = tailCount > 0 ? <>, and {tailCount} more : null; const message = selectedCount <= 1 ?

Remove item {selectedNames}?

:

Remove {selectedCount} items {selectedNames}{tail}?

; ConfirmDialog.open({ ok: removeSelectedItems, labelOk: "Remove", message, ...dialogCustomProps, }); } @boundMethod toggleFilters() { this.showFilters = !this.showFilters; } renderFilters() { const { hideFilters } = this.props; const { isReady, filters } = this; if (!isReady || !filters.length || hideFilters || !this.showFilters) { return null; } return ; } renderNoItems() { if (this.failedToLoad) { return {this.props.failedToLoadMessage}; } if (!this.isReady) { return ; } if (this.filters.length > 0) { return ( No items found.

pageFilters.reset()} className="contrast"> Reset filters?

); } return ; } renderItems() { if (this.props.virtual) { return null; } return this.items.map(item => this.getRow(item.getId())); } renderHeaderContent(placeholders: HeaderPlaceholders): ReactNode { const { searchFilters } = this.props; const { title, filters, searchProps, info } = placeholders; return ( <> {title} { info && (
{info}
) } {filters} {searchFilters.length > 0 && searchProps && } ); } renderInfo() { const { items, filters } = this; const allItemsCount = this.props.store.getTotalCount(); const itemsCount = items.length; if (filters.length > 0) { return ( <>Filtered: {itemsCount} / {allItemsCount} ); } return allItemsCount === 1 ? `${allItemsCount} item` : `${allItemsCount} items`; } renderHeader() { const { showHeader, customizeHeader, renderHeaderTitle, headerClassName } = this.props; if (!showHeader) { return null; } const title = typeof renderHeaderTitle === "function" ? renderHeaderTitle(this) : renderHeaderTitle; const customizeHeaders = [customizeHeader].flat().filter(Boolean); const initialPlaceholders: HeaderPlaceholders = { title:
{title}
, info: this.renderInfo(), searchProps: {}, }; const headerPlaceholders = customizeHeaders.reduce((prevPlaceholders, customizer) => customizer(prevPlaceholders), initialPlaceholders); const header = this.renderHeaderContent(headerPlaceholders); return (
{header}
); } renderTableHeader() { const { customizeTableRowProps, renderTableHeader, isSelectable, isConfigurable, store } = this.props; if (!renderTableHeader) { return null; } const enabledItems = this.items.filter(item => !customizeTableRowProps(item).disabled); return ( {isSelectable && ( store.toggleSelectionAll(enabledItems))} /> )} {renderTableHeader.map((cellProps, index) => ( this.showColumn(cellProps) && ( ) ))} {isConfigurable && this.renderColumnVisibilityMenu()} ); } renderList() { const { store, hasDetailsView, addRemoveButtons = {}, virtual, sortingCallbacks, detailsItem, className, tableProps = {}, tableId, } = this.props; const { removeItemsDialog, items } = this; const { selectedItems } = store; const selectedItemId = detailsItem && detailsItem.getId(); const classNames = cssNames(className, "box", "grow", ThemeStore.getInstance().activeTheme.type); return (
{this.renderTableHeader()} {this.renderItems()}
); } showColumn({ id: columnId, showWithColumn }: TableCellProps): boolean { const { tableId, isConfigurable } = this.props; return !isConfigurable || !UserStore.getInstance().isTableColumnHidden(tableId, columnId, showWithColumn); } renderColumnVisibilityMenu() { const { renderTableHeader, tableId } = this.props; return ( {renderTableHeader.map((cellProps, index) => ( !cellProps.showWithColumn && ( `} value={this.showColumn(cellProps)} onChange={() => UserStore.getInstance().toggleTableColumnVisibility(tableId, cellProps.id)} /> ) ))} ); } renderFooter() { return this.props.renderFooter?.(this); } render() { const { className } = this.props; return (
{this.renderHeader()} {this.renderFilters()} {this.renderList()} {this.renderFooter()}
); } } export function ItemListLayout( props: ItemListLayoutProps, ) { const InjectedItemListLayout = withInjectables< Dependencies, ItemListLayoutProps >( NonInjectedItemListLayout, { getProps: (di, props) => ({ namespaceStore: di.inject(namespaceStoreInjectable), itemListLayoutStorage: di.inject(itemListLayoutStorageInjectable), ...props, }), }, ); return ; }