PageItemControl.tsx 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401
  1. import React, {
  2. useState, useCallback, useEffect, type JSX,
  3. } from 'react';
  4. import {
  5. type IPageInfoExt, isIPageInfoForOperation, isIPageInfoForEmpty,
  6. } from '@growi/core/dist/interfaces';
  7. import { LoadingSpinner } from '@growi/ui/dist/components';
  8. import { useTranslation } from 'next-i18next';
  9. import {
  10. Dropdown, DropdownMenu, DropdownToggle, DropdownItem,
  11. } from 'reactstrap';
  12. import { NotAvailableForGuest } from '~/client/components/NotAvailableForGuest';
  13. import type { IPageOperationProcessData } from '~/interfaces/page-operation';
  14. import { useSWRxPageInfo } from '~/stores/page';
  15. import loggerFactory from '~/utils/logger';
  16. import { shouldRecoverPagePaths } from '~/utils/page-operation';
  17. const logger = loggerFactory('growi:cli:PageItemControl');
  18. export const MenuItemType = {
  19. BOOKMARK: 'bookmark',
  20. RENAME: 'rename',
  21. DUPLICATE: 'duplicate',
  22. DELETE: 'delete',
  23. REVERT: 'revert',
  24. PATH_RECOVERY: 'pathRecovery',
  25. SWITCH_CONTENT_WIDTH: 'switch_content_width',
  26. } as const;
  27. export type MenuItemType = typeof MenuItemType[keyof typeof MenuItemType];
  28. export type ForceHideMenuItems = MenuItemType[];
  29. export type AdditionalMenuItemsRendererProps = { pageInfo: IPageInfoExt };
  30. type CommonProps = {
  31. pageInfo?: IPageInfoExt,
  32. isEnableActions?: boolean,
  33. isReadOnlyUser?: boolean,
  34. forceHideMenuItems?: ForceHideMenuItems,
  35. onClickBookmarkMenuItem?: (pageId: string, newValue?: boolean) => Promise<void>,
  36. onClickRenameMenuItem?: (pageId: string, pageInfo: IPageInfoExt | undefined) => Promise<void> | void,
  37. onClickDuplicateMenuItem?: (pageId: string) => Promise<void> | void,
  38. onClickDeleteMenuItem?: (pageId: string, pageInfo: IPageInfoExt | undefined) => Promise<void> | void,
  39. onClickRevertMenuItem?: (pageId: string) => Promise<void> | void,
  40. onClickPathRecoveryMenuItem?: (pageId: string) => Promise<void> | void,
  41. additionalMenuItemOnTopRenderer?: React.FunctionComponent<AdditionalMenuItemsRendererProps>,
  42. additionalMenuItemRenderer?: React.FunctionComponent<AdditionalMenuItemsRendererProps>,
  43. isInstantRename?: boolean,
  44. alignEnd?: boolean,
  45. }
  46. type DropdownMenuProps = CommonProps & {
  47. pageId: string,
  48. isLoading?: boolean,
  49. isDataUnavailable?: boolean,
  50. operationProcessData?: IPageOperationProcessData,
  51. }
  52. const PageItemControlDropdownMenu = React.memo((props: DropdownMenuProps): JSX.Element => {
  53. const { t } = useTranslation('');
  54. const {
  55. pageId, isLoading, isDataUnavailable, pageInfo, isEnableActions, isReadOnlyUser, forceHideMenuItems, operationProcessData,
  56. onClickBookmarkMenuItem, onClickRenameMenuItem, onClickDuplicateMenuItem, onClickDeleteMenuItem,
  57. onClickRevertMenuItem, onClickPathRecoveryMenuItem,
  58. additionalMenuItemOnTopRenderer: AdditionalMenuItemsOnTop,
  59. additionalMenuItemRenderer: AdditionalMenuItems,
  60. isInstantRename, alignEnd,
  61. } = props;
  62. // eslint-disable-next-line react-hooks/rules-of-hooks
  63. const bookmarkItemClickedHandler = useCallback(async() => {
  64. if (onClickBookmarkMenuItem == null) return;
  65. if (!isIPageInfoForEmpty(pageInfo) && !isIPageInfoForOperation(pageInfo)) {
  66. return;
  67. }
  68. await onClickBookmarkMenuItem(pageId, !pageInfo.isBookmarked);
  69. }, [onClickBookmarkMenuItem, pageId, pageInfo]);
  70. // eslint-disable-next-line react-hooks/rules-of-hooks
  71. const renameItemClickedHandler = useCallback(async() => {
  72. if (onClickRenameMenuItem == null) return;
  73. if (!(isIPageInfoForEmpty(pageInfo) || isIPageInfoForOperation(pageInfo)) || !pageInfo?.isMovable) {
  74. logger.warn('This page could not be renamed.');
  75. return;
  76. }
  77. await onClickRenameMenuItem(pageId, pageInfo);
  78. }, [onClickRenameMenuItem, pageId, pageInfo]);
  79. // eslint-disable-next-line react-hooks/rules-of-hooks
  80. const duplicateItemClickedHandler = useCallback(async() => {
  81. if (onClickDuplicateMenuItem == null) {
  82. return;
  83. }
  84. await onClickDuplicateMenuItem(pageId);
  85. }, [onClickDuplicateMenuItem, pageId]);
  86. const revertItemClickedHandler = useCallback(async() => {
  87. if (onClickRevertMenuItem == null) {
  88. return;
  89. }
  90. await onClickRevertMenuItem(pageId);
  91. }, [onClickRevertMenuItem, pageId]);
  92. // eslint-disable-next-line react-hooks/rules-of-hooks
  93. const deleteItemClickedHandler = useCallback(async() => {
  94. if (onClickDeleteMenuItem == null) return;
  95. if (!(isIPageInfoForEmpty(pageInfo) || isIPageInfoForOperation(pageInfo)) || !pageInfo?.isDeletable) {
  96. logger.warn('This page could not be deleted.');
  97. return;
  98. }
  99. await onClickDeleteMenuItem(pageId, pageInfo);
  100. }, [onClickDeleteMenuItem, pageId, pageInfo]);
  101. // eslint-disable-next-line react-hooks/rules-of-hooks
  102. const pathRecoveryItemClickedHandler = useCallback(async() => {
  103. if (onClickPathRecoveryMenuItem == null) {
  104. return;
  105. }
  106. await onClickPathRecoveryMenuItem(pageId);
  107. }, [onClickPathRecoveryMenuItem, pageId]);
  108. let contents = <></>;
  109. if (isDataUnavailable) {
  110. // Show message when data is not available (e.g., fetch error)
  111. contents = (
  112. <div className="text-warning text-center px-3">
  113. <span className="material-symbols-outlined">error_outline</span> No data available
  114. </div>
  115. );
  116. }
  117. else if (isLoading) {
  118. contents = (
  119. <div className="text-muted text-center my-2">
  120. <LoadingSpinner />
  121. </div>
  122. );
  123. }
  124. else if (pageId != null && pageInfo != null) {
  125. const showDeviderBeforeAdditionalMenuItems = (forceHideMenuItems?.length ?? 0) < 3;
  126. const showDeviderBeforeDelete = AdditionalMenuItems != null || showDeviderBeforeAdditionalMenuItems;
  127. // PathRecovery
  128. // Todo: It is wanted to find a better way to pass operationProcessData to PageItemControl
  129. const shouldShowPathRecoveryButton = operationProcessData != null ? shouldRecoverPagePaths(operationProcessData) : false;
  130. contents = (
  131. <>
  132. { !isEnableActions && (
  133. <DropdownItem>
  134. <p>
  135. {t('search_result.currently_not_implemented')}
  136. </p>
  137. </DropdownItem>
  138. ) }
  139. { AdditionalMenuItemsOnTop && (
  140. <>
  141. <AdditionalMenuItemsOnTop pageInfo={pageInfo} />
  142. <DropdownItem divider />
  143. </>
  144. ) }
  145. {/* Bookmark */}
  146. { !forceHideMenuItems?.includes(MenuItemType.BOOKMARK) && isEnableActions && (isIPageInfoForEmpty(pageInfo) || isIPageInfoForOperation(pageInfo)) && (
  147. <DropdownItem
  148. onClick={bookmarkItemClickedHandler}
  149. className="grw-page-control-dropdown-item"
  150. data-testid={pageInfo.isBookmarked ? 'remove-bookmark-btn' : 'add-bookmark-btn'}
  151. >
  152. <span className="material-symbols-outlined grw-page-control-dropdown-icon">bookmark</span>
  153. { pageInfo.isBookmarked ? t('remove_bookmark') : t('add_bookmark') }
  154. </DropdownItem>
  155. ) }
  156. {/* Move/Rename */}
  157. { !forceHideMenuItems?.includes(MenuItemType.RENAME) && isEnableActions && !isReadOnlyUser
  158. && (isIPageInfoForEmpty(pageInfo) || isIPageInfoForOperation(pageInfo))
  159. && pageInfo.isMovable && (
  160. <DropdownItem
  161. onClick={renameItemClickedHandler}
  162. data-testid="rename-page-btn"
  163. className="grw-page-control-dropdown-item"
  164. >
  165. <span className="material-symbols-outlined me-1 grw-page-control-dropdown-icon">redo</span>
  166. {t(isInstantRename ? 'Rename' : 'Move/Rename')}
  167. </DropdownItem>
  168. ) }
  169. {/* Duplicate */}
  170. { !forceHideMenuItems?.includes(MenuItemType.DUPLICATE) && isEnableActions && !isReadOnlyUser && (
  171. <DropdownItem
  172. onClick={duplicateItemClickedHandler}
  173. data-testid="open-page-duplicate-modal-btn"
  174. className="grw-page-control-dropdown-item"
  175. >
  176. <span className="material-symbols-outlined me-1 grw-page-control-dropdown-icon">file_copy</span>
  177. {t('Duplicate')}
  178. </DropdownItem>
  179. ) }
  180. {/* Revert */}
  181. { !forceHideMenuItems?.includes(MenuItemType.REVERT) && isEnableActions && !isReadOnlyUser
  182. && (isIPageInfoForEmpty(pageInfo) || isIPageInfoForOperation(pageInfo))
  183. && pageInfo.isRevertible && (
  184. <DropdownItem
  185. onClick={revertItemClickedHandler}
  186. className="grw-page-control-dropdown-item"
  187. >
  188. <span className="material-symbols-outlined me-1 grw-page-control-dropdown-icon">undo</span>
  189. {t('modal_putback.label.Put Back Page')}
  190. </DropdownItem>
  191. ) }
  192. { AdditionalMenuItems && (
  193. <>
  194. { showDeviderBeforeAdditionalMenuItems && <DropdownItem divider /> }
  195. <AdditionalMenuItems pageInfo={pageInfo} />
  196. </>
  197. ) }
  198. {/* PathRecovery */}
  199. { !forceHideMenuItems?.includes(MenuItemType.PATH_RECOVERY) && isEnableActions && !isReadOnlyUser && shouldShowPathRecoveryButton && (
  200. <DropdownItem
  201. onClick={pathRecoveryItemClickedHandler}
  202. className="grw-page-control-dropdown-item"
  203. >
  204. <span className="material-symbols-outlined me-1 grw-page-control-dropdown-icon">build</span>
  205. {t('PathRecovery')}
  206. </DropdownItem>
  207. ) }
  208. {/* divider */}
  209. {/* Delete */}
  210. { !forceHideMenuItems?.includes(MenuItemType.DELETE) && isEnableActions && !isReadOnlyUser
  211. && (isIPageInfoForEmpty(pageInfo) || isIPageInfoForOperation(pageInfo))
  212. && pageInfo.isDeletable && (
  213. <>
  214. { showDeviderBeforeDelete && <DropdownItem divider /> }
  215. <DropdownItem
  216. className={`pt-2 grw-page-control-dropdown-item ${pageInfo.isDeletable ? 'text-danger' : ''}`}
  217. disabled={!pageInfo.isDeletable}
  218. onClick={deleteItemClickedHandler}
  219. data-testid="open-page-delete-modal-btn"
  220. >
  221. <span className="material-symbols-outlined me-1 grw-page-control-dropdown-icon">delete</span>
  222. {t('Delete')}
  223. </DropdownItem>
  224. </>
  225. )}
  226. </>
  227. );
  228. }
  229. return (
  230. <DropdownMenu
  231. className="d-print-none"
  232. data-testid="page-item-control-menu"
  233. end={alignEnd}
  234. container="body"
  235. persist={!!alignEnd}
  236. style={{ zIndex: 1055 }} /* make it larger than $zindex-modal of bootstrap */
  237. >
  238. {contents}
  239. </DropdownMenu>
  240. );
  241. });
  242. PageItemControlDropdownMenu.displayName = 'PageItemControl';
  243. type PageItemControlSubstanceProps = CommonProps & {
  244. pageId: string,
  245. children?: React.ReactNode,
  246. operationProcessData?: IPageOperationProcessData,
  247. }
  248. export const PageItemControlSubstance = (props: PageItemControlSubstanceProps): JSX.Element => {
  249. const {
  250. pageId, pageInfo: presetPageInfo, children, onClickBookmarkMenuItem, onClickRenameMenuItem,
  251. onClickDuplicateMenuItem, onClickDeleteMenuItem, onClickPathRecoveryMenuItem,
  252. } = props;
  253. const [isOpen, setIsOpen] = useState(false);
  254. const [shouldFetch, setShouldFetch] = useState(false);
  255. const { data: fetchedPageInfo, error: fetchError, mutate: mutatePageInfo } = useSWRxPageInfo(shouldFetch ? pageId : null);
  256. // update shouldFetch (and will never be false)
  257. useEffect(() => {
  258. if (shouldFetch) {
  259. return;
  260. }
  261. if (!isIPageInfoForOperation(presetPageInfo) && isOpen) {
  262. setShouldFetch(true);
  263. }
  264. }, [isOpen, presetPageInfo, shouldFetch]);
  265. // mutate after handle event
  266. const bookmarkMenuItemClickHandler = useCallback(async(_pageId: string, _newValue: boolean) => {
  267. if (onClickBookmarkMenuItem != null) {
  268. await onClickBookmarkMenuItem(_pageId, _newValue);
  269. }
  270. if (shouldFetch) {
  271. mutatePageInfo();
  272. }
  273. }, [mutatePageInfo, onClickBookmarkMenuItem, shouldFetch]);
  274. // isLoading should be true only when fetching is in progress (data and error are both undefined)
  275. const isLoading = shouldFetch && fetchedPageInfo == null && fetchError == null;
  276. const isDataUnavailable = !isLoading && fetchedPageInfo == null && presetPageInfo == null;
  277. const renameMenuItemClickHandler = useCallback(async() => {
  278. if (onClickRenameMenuItem == null) {
  279. return;
  280. }
  281. await onClickRenameMenuItem(pageId, fetchedPageInfo ?? presetPageInfo);
  282. }, [onClickRenameMenuItem, pageId, fetchedPageInfo, presetPageInfo]);
  283. const duplicateMenuItemClickHandler = useCallback(async() => {
  284. if (onClickDuplicateMenuItem == null) {
  285. return;
  286. }
  287. await onClickDuplicateMenuItem(pageId);
  288. }, [onClickDuplicateMenuItem, pageId]);
  289. const deleteMenuItemClickHandler = useCallback(async() => {
  290. if (onClickDeleteMenuItem == null) {
  291. return;
  292. }
  293. await onClickDeleteMenuItem(pageId, fetchedPageInfo ?? presetPageInfo);
  294. }, [onClickDeleteMenuItem, pageId, fetchedPageInfo, presetPageInfo]);
  295. const pathRecoveryMenuItemClickHandler = useCallback(async() => {
  296. if (onClickPathRecoveryMenuItem == null) {
  297. return;
  298. }
  299. await onClickPathRecoveryMenuItem(pageId);
  300. }, [onClickPathRecoveryMenuItem, pageId]);
  301. return (
  302. <NotAvailableForGuest>
  303. <Dropdown isOpen={isOpen} toggle={() => setIsOpen(!isOpen)} className="grw-page-item-control" data-testid="open-page-item-control-btn">
  304. { children ?? (
  305. <DropdownToggle role="button" color="transparent" className="border-0 rounded btn-page-item-control d-flex align-items-center justify-content-center">
  306. <span className="material-symbols-outlined">more_vert</span>
  307. </DropdownToggle>
  308. ) }
  309. { isOpen && (
  310. <PageItemControlDropdownMenu
  311. {...props}
  312. isLoading={isLoading}
  313. isDataUnavailable={isDataUnavailable}
  314. pageInfo={fetchedPageInfo ?? presetPageInfo}
  315. onClickBookmarkMenuItem={bookmarkMenuItemClickHandler}
  316. onClickRenameMenuItem={renameMenuItemClickHandler}
  317. onClickDuplicateMenuItem={duplicateMenuItemClickHandler}
  318. onClickDeleteMenuItem={deleteMenuItemClickHandler}
  319. onClickPathRecoveryMenuItem={pathRecoveryMenuItemClickHandler}
  320. />
  321. ) }
  322. </Dropdown>
  323. </NotAvailableForGuest>
  324. );
  325. };
  326. export type PageItemControlProps = CommonProps & {
  327. pageId?: string,
  328. children?: React.ReactNode,
  329. operationProcessData?: IPageOperationProcessData,
  330. }
  331. export const PageItemControl = (props: PageItemControlProps): JSX.Element => {
  332. const { pageId } = props;
  333. if (pageId == null) {
  334. return <></>;
  335. }
  336. return <PageItemControlSubstance pageId={pageId} {...props} />;
  337. };