| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401 |
- import React, {
- useState, useCallback, useEffect, type JSX,
- } from 'react';
- import {
- type IPageInfoExt, isIPageInfoForOperation, isIPageInfoForEmpty,
- } from '@growi/core/dist/interfaces';
- import { LoadingSpinner } from '@growi/ui/dist/components';
- import { useTranslation } from 'next-i18next';
- import {
- Dropdown, DropdownMenu, DropdownToggle, DropdownItem,
- } from 'reactstrap';
- import { NotAvailableForGuest } from '~/client/components/NotAvailableForGuest';
- import type { IPageOperationProcessData } from '~/interfaces/page-operation';
- import { useSWRxPageInfo } from '~/stores/page';
- import loggerFactory from '~/utils/logger';
- import { shouldRecoverPagePaths } from '~/utils/page-operation';
- const logger = loggerFactory('growi:cli:PageItemControl');
- export const MenuItemType = {
- BOOKMARK: 'bookmark',
- RENAME: 'rename',
- DUPLICATE: 'duplicate',
- DELETE: 'delete',
- REVERT: 'revert',
- PATH_RECOVERY: 'pathRecovery',
- SWITCH_CONTENT_WIDTH: 'switch_content_width',
- } as const;
- export type MenuItemType = typeof MenuItemType[keyof typeof MenuItemType];
- export type ForceHideMenuItems = MenuItemType[];
- export type AdditionalMenuItemsRendererProps = { pageInfo: IPageInfoExt };
- type CommonProps = {
- pageInfo?: IPageInfoExt,
- isEnableActions?: boolean,
- isReadOnlyUser?: boolean,
- forceHideMenuItems?: ForceHideMenuItems,
- onClickBookmarkMenuItem?: (pageId: string, newValue?: boolean) => Promise<void>,
- onClickRenameMenuItem?: (pageId: string, pageInfo: IPageInfoExt | undefined) => Promise<void> | void,
- onClickDuplicateMenuItem?: (pageId: string) => Promise<void> | void,
- onClickDeleteMenuItem?: (pageId: string, pageInfo: IPageInfoExt | undefined) => Promise<void> | void,
- onClickRevertMenuItem?: (pageId: string) => Promise<void> | void,
- onClickPathRecoveryMenuItem?: (pageId: string) => Promise<void> | void,
- additionalMenuItemOnTopRenderer?: React.FunctionComponent<AdditionalMenuItemsRendererProps>,
- additionalMenuItemRenderer?: React.FunctionComponent<AdditionalMenuItemsRendererProps>,
- isInstantRename?: boolean,
- alignEnd?: boolean,
- }
- type DropdownMenuProps = CommonProps & {
- pageId: string,
- isLoading?: boolean,
- isDataUnavailable?: boolean,
- operationProcessData?: IPageOperationProcessData,
- }
- const PageItemControlDropdownMenu = React.memo((props: DropdownMenuProps): JSX.Element => {
- const { t } = useTranslation('');
- const {
- pageId, isLoading, isDataUnavailable, pageInfo, isEnableActions, isReadOnlyUser, forceHideMenuItems, operationProcessData,
- onClickBookmarkMenuItem, onClickRenameMenuItem, onClickDuplicateMenuItem, onClickDeleteMenuItem,
- onClickRevertMenuItem, onClickPathRecoveryMenuItem,
- additionalMenuItemOnTopRenderer: AdditionalMenuItemsOnTop,
- additionalMenuItemRenderer: AdditionalMenuItems,
- isInstantRename, alignEnd,
- } = props;
- // eslint-disable-next-line react-hooks/rules-of-hooks
- const bookmarkItemClickedHandler = useCallback(async() => {
- if (onClickBookmarkMenuItem == null) return;
- if (!isIPageInfoForEmpty(pageInfo) && !isIPageInfoForOperation(pageInfo)) {
- return;
- }
- await onClickBookmarkMenuItem(pageId, !pageInfo.isBookmarked);
- }, [onClickBookmarkMenuItem, pageId, pageInfo]);
- // eslint-disable-next-line react-hooks/rules-of-hooks
- const renameItemClickedHandler = useCallback(async() => {
- if (onClickRenameMenuItem == null) return;
- if (!(isIPageInfoForEmpty(pageInfo) || isIPageInfoForOperation(pageInfo)) || !pageInfo?.isMovable) {
- logger.warn('This page could not be renamed.');
- return;
- }
- await onClickRenameMenuItem(pageId, pageInfo);
- }, [onClickRenameMenuItem, pageId, pageInfo]);
- // eslint-disable-next-line react-hooks/rules-of-hooks
- const duplicateItemClickedHandler = useCallback(async() => {
- if (onClickDuplicateMenuItem == null) {
- return;
- }
- await onClickDuplicateMenuItem(pageId);
- }, [onClickDuplicateMenuItem, pageId]);
- const revertItemClickedHandler = useCallback(async() => {
- if (onClickRevertMenuItem == null) {
- return;
- }
- await onClickRevertMenuItem(pageId);
- }, [onClickRevertMenuItem, pageId]);
- // eslint-disable-next-line react-hooks/rules-of-hooks
- const deleteItemClickedHandler = useCallback(async() => {
- if (onClickDeleteMenuItem == null) return;
- if (!(isIPageInfoForEmpty(pageInfo) || isIPageInfoForOperation(pageInfo)) || !pageInfo?.isDeletable) {
- logger.warn('This page could not be deleted.');
- return;
- }
- await onClickDeleteMenuItem(pageId, pageInfo);
- }, [onClickDeleteMenuItem, pageId, pageInfo]);
- // eslint-disable-next-line react-hooks/rules-of-hooks
- const pathRecoveryItemClickedHandler = useCallback(async() => {
- if (onClickPathRecoveryMenuItem == null) {
- return;
- }
- await onClickPathRecoveryMenuItem(pageId);
- }, [onClickPathRecoveryMenuItem, pageId]);
- let contents = <></>;
- if (isDataUnavailable) {
- // Show message when data is not available (e.g., fetch error)
- contents = (
- <div className="text-warning text-center px-3">
- <span className="material-symbols-outlined">error_outline</span> No data available
- </div>
- );
- }
- else if (isLoading) {
- contents = (
- <div className="text-muted text-center my-2">
- <LoadingSpinner />
- </div>
- );
- }
- else if (pageId != null && pageInfo != null) {
- const showDeviderBeforeAdditionalMenuItems = (forceHideMenuItems?.length ?? 0) < 3;
- const showDeviderBeforeDelete = AdditionalMenuItems != null || showDeviderBeforeAdditionalMenuItems;
- // PathRecovery
- // Todo: It is wanted to find a better way to pass operationProcessData to PageItemControl
- const shouldShowPathRecoveryButton = operationProcessData != null ? shouldRecoverPagePaths(operationProcessData) : false;
- contents = (
- <>
- { !isEnableActions && (
- <DropdownItem>
- <p>
- {t('search_result.currently_not_implemented')}
- </p>
- </DropdownItem>
- ) }
- { AdditionalMenuItemsOnTop && (
- <>
- <AdditionalMenuItemsOnTop pageInfo={pageInfo} />
- <DropdownItem divider />
- </>
- ) }
- {/* Bookmark */}
- { !forceHideMenuItems?.includes(MenuItemType.BOOKMARK) && isEnableActions && (isIPageInfoForEmpty(pageInfo) || isIPageInfoForOperation(pageInfo)) && (
- <DropdownItem
- onClick={bookmarkItemClickedHandler}
- className="grw-page-control-dropdown-item"
- data-testid={pageInfo.isBookmarked ? 'remove-bookmark-btn' : 'add-bookmark-btn'}
- >
- <span className="material-symbols-outlined grw-page-control-dropdown-icon">bookmark</span>
- { pageInfo.isBookmarked ? t('remove_bookmark') : t('add_bookmark') }
- </DropdownItem>
- ) }
- {/* Move/Rename */}
- { !forceHideMenuItems?.includes(MenuItemType.RENAME) && isEnableActions && !isReadOnlyUser
- && (isIPageInfoForEmpty(pageInfo) || isIPageInfoForOperation(pageInfo))
- && pageInfo.isMovable && (
- <DropdownItem
- onClick={renameItemClickedHandler}
- data-testid="rename-page-btn"
- className="grw-page-control-dropdown-item"
- >
- <span className="material-symbols-outlined me-1 grw-page-control-dropdown-icon">redo</span>
- {t(isInstantRename ? 'Rename' : 'Move/Rename')}
- </DropdownItem>
- ) }
- {/* Duplicate */}
- { !forceHideMenuItems?.includes(MenuItemType.DUPLICATE) && isEnableActions && !isReadOnlyUser && (
- <DropdownItem
- onClick={duplicateItemClickedHandler}
- data-testid="open-page-duplicate-modal-btn"
- className="grw-page-control-dropdown-item"
- >
- <span className="material-symbols-outlined me-1 grw-page-control-dropdown-icon">file_copy</span>
- {t('Duplicate')}
- </DropdownItem>
- ) }
- {/* Revert */}
- { !forceHideMenuItems?.includes(MenuItemType.REVERT) && isEnableActions && !isReadOnlyUser
- && (isIPageInfoForEmpty(pageInfo) || isIPageInfoForOperation(pageInfo))
- && pageInfo.isRevertible && (
- <DropdownItem
- onClick={revertItemClickedHandler}
- className="grw-page-control-dropdown-item"
- >
- <span className="material-symbols-outlined me-1 grw-page-control-dropdown-icon">undo</span>
- {t('modal_putback.label.Put Back Page')}
- </DropdownItem>
- ) }
- { AdditionalMenuItems && (
- <>
- { showDeviderBeforeAdditionalMenuItems && <DropdownItem divider /> }
- <AdditionalMenuItems pageInfo={pageInfo} />
- </>
- ) }
- {/* PathRecovery */}
- { !forceHideMenuItems?.includes(MenuItemType.PATH_RECOVERY) && isEnableActions && !isReadOnlyUser && shouldShowPathRecoveryButton && (
- <DropdownItem
- onClick={pathRecoveryItemClickedHandler}
- className="grw-page-control-dropdown-item"
- >
- <span className="material-symbols-outlined me-1 grw-page-control-dropdown-icon">build</span>
- {t('PathRecovery')}
- </DropdownItem>
- ) }
- {/* divider */}
- {/* Delete */}
- { !forceHideMenuItems?.includes(MenuItemType.DELETE) && isEnableActions && !isReadOnlyUser
- && (isIPageInfoForEmpty(pageInfo) || isIPageInfoForOperation(pageInfo))
- && pageInfo.isDeletable && (
- <>
- { showDeviderBeforeDelete && <DropdownItem divider /> }
- <DropdownItem
- className={`pt-2 grw-page-control-dropdown-item ${pageInfo.isDeletable ? 'text-danger' : ''}`}
- disabled={!pageInfo.isDeletable}
- onClick={deleteItemClickedHandler}
- data-testid="open-page-delete-modal-btn"
- >
- <span className="material-symbols-outlined me-1 grw-page-control-dropdown-icon">delete</span>
- {t('Delete')}
- </DropdownItem>
- </>
- )}
- </>
- );
- }
- return (
- <DropdownMenu
- className="d-print-none"
- data-testid="page-item-control-menu"
- end={alignEnd}
- container="body"
- persist={!!alignEnd}
- style={{ zIndex: 1055 }} /* make it larger than $zindex-modal of bootstrap */
- >
- {contents}
- </DropdownMenu>
- );
- });
- PageItemControlDropdownMenu.displayName = 'PageItemControl';
- type PageItemControlSubstanceProps = CommonProps & {
- pageId: string,
- children?: React.ReactNode,
- operationProcessData?: IPageOperationProcessData,
- }
- export const PageItemControlSubstance = (props: PageItemControlSubstanceProps): JSX.Element => {
- const {
- pageId, pageInfo: presetPageInfo, children, onClickBookmarkMenuItem, onClickRenameMenuItem,
- onClickDuplicateMenuItem, onClickDeleteMenuItem, onClickPathRecoveryMenuItem,
- } = props;
- const [isOpen, setIsOpen] = useState(false);
- const [shouldFetch, setShouldFetch] = useState(false);
- const { data: fetchedPageInfo, error: fetchError, mutate: mutatePageInfo } = useSWRxPageInfo(shouldFetch ? pageId : null);
- // update shouldFetch (and will never be false)
- useEffect(() => {
- if (shouldFetch) {
- return;
- }
- if (!isIPageInfoForOperation(presetPageInfo) && isOpen) {
- setShouldFetch(true);
- }
- }, [isOpen, presetPageInfo, shouldFetch]);
- // mutate after handle event
- const bookmarkMenuItemClickHandler = useCallback(async(_pageId: string, _newValue: boolean) => {
- if (onClickBookmarkMenuItem != null) {
- await onClickBookmarkMenuItem(_pageId, _newValue);
- }
- if (shouldFetch) {
- mutatePageInfo();
- }
- }, [mutatePageInfo, onClickBookmarkMenuItem, shouldFetch]);
- // isLoading should be true only when fetching is in progress (data and error are both undefined)
- const isLoading = shouldFetch && fetchedPageInfo == null && fetchError == null;
- const isDataUnavailable = !isLoading && fetchedPageInfo == null && presetPageInfo == null;
- const renameMenuItemClickHandler = useCallback(async() => {
- if (onClickRenameMenuItem == null) {
- return;
- }
- await onClickRenameMenuItem(pageId, fetchedPageInfo ?? presetPageInfo);
- }, [onClickRenameMenuItem, pageId, fetchedPageInfo, presetPageInfo]);
- const duplicateMenuItemClickHandler = useCallback(async() => {
- if (onClickDuplicateMenuItem == null) {
- return;
- }
- await onClickDuplicateMenuItem(pageId);
- }, [onClickDuplicateMenuItem, pageId]);
- const deleteMenuItemClickHandler = useCallback(async() => {
- if (onClickDeleteMenuItem == null) {
- return;
- }
- await onClickDeleteMenuItem(pageId, fetchedPageInfo ?? presetPageInfo);
- }, [onClickDeleteMenuItem, pageId, fetchedPageInfo, presetPageInfo]);
- const pathRecoveryMenuItemClickHandler = useCallback(async() => {
- if (onClickPathRecoveryMenuItem == null) {
- return;
- }
- await onClickPathRecoveryMenuItem(pageId);
- }, [onClickPathRecoveryMenuItem, pageId]);
- return (
- <NotAvailableForGuest>
- <Dropdown isOpen={isOpen} toggle={() => setIsOpen(!isOpen)} className="grw-page-item-control" data-testid="open-page-item-control-btn">
- { children ?? (
- <DropdownToggle role="button" color="transparent" className="border-0 rounded btn-page-item-control d-flex align-items-center justify-content-center">
- <span className="material-symbols-outlined">more_vert</span>
- </DropdownToggle>
- ) }
- { isOpen && (
- <PageItemControlDropdownMenu
- {...props}
- isLoading={isLoading}
- isDataUnavailable={isDataUnavailable}
- pageInfo={fetchedPageInfo ?? presetPageInfo}
- onClickBookmarkMenuItem={bookmarkMenuItemClickHandler}
- onClickRenameMenuItem={renameMenuItemClickHandler}
- onClickDuplicateMenuItem={duplicateMenuItemClickHandler}
- onClickDeleteMenuItem={deleteMenuItemClickHandler}
- onClickPathRecoveryMenuItem={pathRecoveryMenuItemClickHandler}
- />
- ) }
- </Dropdown>
- </NotAvailableForGuest>
- );
- };
- export type PageItemControlProps = CommonProps & {
- pageId?: string,
- children?: React.ReactNode,
- operationProcessData?: IPageOperationProcessData,
- }
- export const PageItemControl = (props: PageItemControlProps): JSX.Element => {
- const { pageId } = props;
- if (pageId == null) {
- return <></>;
- }
- return <PageItemControlSubstance pageId={pageId} {...props} />;
- };
|