PageItemControl.tsx 13 KB

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