Editor.tsx 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365
  1. import type { ForwardRefRenderFunction } from 'react';
  2. import React, {
  3. useState, useRef, useImperativeHandle, useCallback, forwardRef,
  4. memo,
  5. useEffect,
  6. } from 'react';
  7. import Dropzone from 'react-dropzone';
  8. import { useTranslation } from 'react-i18next';
  9. import {
  10. Modal, ModalHeader, ModalBody,
  11. } from 'reactstrap';
  12. import { toastError, toastSuccess } from '~/client/util/toastr';
  13. import type { IEditorSettings } from '~/interfaces/editor-settings';
  14. import { useDefaultIndentSize } from '~/stores/context';
  15. import { useEditorSettings } from '~/stores/editor';
  16. import { useIsMobile } from '~/stores/ui';
  17. import type { IEditorMethods } from '../../interfaces/editor-methods';
  18. import type AbstractEditor from './AbstractEditor';
  19. import { Cheatsheet } from './Cheatsheet';
  20. // import CodeMirrorEditor from './CodeMirrorEditor';
  21. import pasteHelper from './PasteHelper';
  22. import TextAreaEditor from './TextAreaEditor';
  23. import styles from './Editor.module.scss';
  24. export type EditorPropsType = {
  25. value?: string,
  26. isGfmMode?: boolean,
  27. noCdn?: boolean,
  28. isUploadable?: boolean,
  29. isUploadAllFileAllowed?: boolean,
  30. onChange?: (newValue: string, isClean?: boolean) => void,
  31. onUpload?: (file) => void,
  32. editorSettings?: IEditorSettings,
  33. indentSize?: number,
  34. onDragEnter?: (event: any) => void,
  35. onMarkdownHelpButtonClicked?: () => void,
  36. onAddAttachmentButtonClicked?: () => void,
  37. onScroll?: (line: { line: number }) => void,
  38. onScrollCursorIntoView?: (line: number) => void,
  39. onSave?: () => Promise<void>,
  40. onPasteFiles?: (event: Event) => void,
  41. onCtrlEnter?: (event: Event) => void,
  42. isComment?: boolean,
  43. }
  44. type DropzoneRef = {
  45. open: () => void
  46. }
  47. const Editor: ForwardRefRenderFunction<IEditorMethods, EditorPropsType> = (props, ref): JSX.Element => {
  48. const {
  49. onUpload, isUploadable, isUploadAllFileAllowed, indentSize, isGfmMode = true,
  50. } = props;
  51. const [dropzoneActive, setDropzoneActive] = useState(false);
  52. const [isUploading, setIsUploading] = useState(false);
  53. const [isCheatsheetModalShown, setIsCheatsheetModalShown] = useState(false);
  54. const [navBarItems, setNavBarItems] = useState<JSX.Element[]>([]);
  55. const { t } = useTranslation();
  56. const { data: editorSettings } = useEditorSettings();
  57. const { data: defaultIndentSize } = useDefaultIndentSize();
  58. const { data: isMobile } = useIsMobile();
  59. const dropzoneRef = useRef<DropzoneRef>(null);
  60. // CodeMirrorEditor ref
  61. const cmEditorRef = useRef<AbstractEditor<any>>(null);
  62. const taEditorRef = useRef<TextAreaEditor>(null);
  63. const editorSubstance = useCallback(() => {
  64. return isMobile ? taEditorRef.current : cmEditorRef.current;
  65. }, [isMobile]);
  66. // methods for ref
  67. useImperativeHandle(ref, () => ({
  68. forceToFocus: () => {
  69. editorSubstance()?.forceToFocus();
  70. },
  71. setValue: (newValue: string) => {
  72. editorSubstance()?.setValue(newValue);
  73. },
  74. setGfmMode: (bool: boolean) => {
  75. editorSubstance()?.setGfmMode(bool);
  76. },
  77. setCaretLine: (line: number) => {
  78. editorSubstance()?.setCaretLine(line);
  79. },
  80. setScrollTopByLine: (line: number) => {
  81. editorSubstance()?.setScrollTopByLine(line);
  82. },
  83. insertText: (text: string) => {
  84. editorSubstance()?.insertText(text);
  85. },
  86. /**
  87. * remove overlay and set isUploading to false
  88. */
  89. terminateUploadingState: () => {
  90. setDropzoneActive(false);
  91. setIsUploading(false);
  92. },
  93. }));
  94. /**
  95. * dispatch onUpload event
  96. */
  97. const dispatchUpload = useCallback((files) => {
  98. if (onUpload != null) {
  99. onUpload(files);
  100. }
  101. }, [onUpload]);
  102. /**
  103. * get acceptable(uploadable) file type
  104. */
  105. const getAcceptableType = useCallback(() => {
  106. let accept = 'null'; // reject all
  107. if (isUploadable) {
  108. if (!isUploadAllFileAllowed) {
  109. accept = 'image/*'; // image only
  110. }
  111. else {
  112. accept = ''; // allow all
  113. }
  114. }
  115. return accept;
  116. }, [isUploadable, isUploadAllFileAllowed]);
  117. const pasteFilesHandler = useCallback((event) => {
  118. const items = event.clipboardData.items || event.clipboardData.files || [];
  119. // abort if length is not 1
  120. if (items.length < 1) {
  121. return;
  122. }
  123. for (let i = 0; i < items.length; i++) {
  124. try {
  125. const file = items[i].getAsFile();
  126. // check file type (the same process as Dropzone)
  127. if (file != null && pasteHelper.isAcceptableType(file, getAcceptableType())) {
  128. dispatchUpload(file);
  129. setIsUploading(true);
  130. }
  131. }
  132. catch (e) {
  133. toastError(t('toaster.file_upload_failed'));
  134. }
  135. }
  136. }, [dispatchUpload, getAcceptableType, t]);
  137. const dragEnterHandler = useCallback((event) => {
  138. const dataTransfer = event.dataTransfer;
  139. // do nothing if contents is not files
  140. if (!dataTransfer.types.includes('Files')) {
  141. return;
  142. }
  143. setDropzoneActive(true);
  144. }, []);
  145. const dropHandler = useCallback((accepted) => {
  146. // rejected
  147. if (accepted.length !== 1) { // length should be 0 or 1 because `multiple={false}` is set
  148. setDropzoneActive(false);
  149. return;
  150. }
  151. const file = accepted[0];
  152. dispatchUpload(file);
  153. setIsUploading(true);
  154. }, [dispatchUpload]);
  155. const addAttachmentHandler = useCallback(() => {
  156. if (dropzoneRef.current == null) { return }
  157. dropzoneRef.current.open();
  158. }, []);
  159. const getDropzoneClassName = useCallback((isDragAccept: boolean, isDragReject: boolean) => {
  160. let className = 'dropzone';
  161. if (!isUploadable) {
  162. className += ' dropzone-unuploadable';
  163. }
  164. else {
  165. className += ' dropzone-uploadable';
  166. if (isUploadAllFileAllowed) {
  167. className += ' dropzone-uploadablefile';
  168. }
  169. }
  170. // uploading
  171. if (isUploading) {
  172. className += ' dropzone-uploading';
  173. }
  174. if (isDragAccept) {
  175. className += ' dropzone-accepted';
  176. }
  177. if (isDragReject) {
  178. className += ' dropzone-rejected';
  179. }
  180. return className;
  181. }, [isUploadable, isUploading, isUploadAllFileAllowed]);
  182. const renderDropzoneOverlay = useCallback(() => {
  183. return (
  184. <div className="overlay overlay-dropzone-active">
  185. {isUploading
  186. && (
  187. <span className="overlay-content">
  188. <div className="speeding-wheel d-inline-block"></div>
  189. <span className="visually-hidden">Uploading...</span>
  190. </span>
  191. )
  192. }
  193. {!isUploading && <span className="overlay-content"></span>}
  194. </div>
  195. );
  196. }, [isUploading]);
  197. const renderNavbar = () => {
  198. return (
  199. <div className="m-0 navbar navbar-default navbar-editor" data-testid="navbar-editor" style={{ minHeight: 'unset' }}>
  200. <ul className="ps-2 nav nav-navbar">
  201. { navBarItems.map((item, idx) => {
  202. // eslint-disable-next-line react/no-array-index-key
  203. return <li key={`navbarItem-${idx}`}>{item}</li>;
  204. }) }
  205. </ul>
  206. </div>
  207. );
  208. };
  209. const renderCheatsheetModal = useCallback(() => {
  210. const hideCheatsheetModal = () => {
  211. setIsCheatsheetModalShown(false);
  212. };
  213. return (
  214. <Modal isOpen={isCheatsheetModalShown} toggle={hideCheatsheetModal} className={`modal-gfm-cheatsheet ${styles['modal-gfm-cheatsheet']}`} size="lg">
  215. <ModalHeader tag="h4" toggle={hideCheatsheetModal} className="bg-primary text-light">
  216. <span className="material-symbols-outlined me-1">help</span>Markdown help
  217. </ModalHeader>
  218. <ModalBody>
  219. <Cheatsheet />
  220. </ModalBody>
  221. </Modal>
  222. );
  223. }, [isCheatsheetModalShown]);
  224. const isReadyToRenderEditor = editorSettings != null;
  225. // https://redmine.weseek.co.jp/issues/111731
  226. useEffect(() => {
  227. const editorRef = editorSubstance();
  228. if (isReadyToRenderEditor && editorRef != null) {
  229. const editorNavBarItems = editorRef.getNavbarItems() ?? [];
  230. setNavBarItems(editorNavBarItems);
  231. }
  232. }, [editorSubstance, isReadyToRenderEditor]);
  233. if (!isReadyToRenderEditor) {
  234. return <></>;
  235. }
  236. const flexContainer: React.CSSProperties = {
  237. height: '100%',
  238. display: 'flex',
  239. flexDirection: 'column',
  240. };
  241. return (
  242. <>
  243. <div style={flexContainer} className={`editor-container ${styles['editor-container']}`}>
  244. <Dropzone
  245. ref={dropzoneRef}
  246. accept={getAcceptableType()}
  247. noClick
  248. noKeyboard
  249. multiple={false}
  250. onDragLeave={() => { setDropzoneActive(false) }}
  251. onDrop={dropHandler}
  252. >
  253. {({
  254. getRootProps,
  255. getInputProps,
  256. isDragAccept,
  257. isDragReject,
  258. }) => {
  259. return (
  260. <div className={getDropzoneClassName(isDragAccept, isDragReject)} {...getRootProps()}>
  261. { dropzoneActive && renderDropzoneOverlay() }
  262. { renderNavbar() }
  263. {/* for PC */}
  264. { !isMobile && (
  265. // <CodeMirrorEditor
  266. // ref={cmEditorRef}
  267. // indentSize={indentSize ?? defaultIndentSize}
  268. // onPasteFiles={pasteFilesHandler}
  269. // onDragEnter={dragEnterHandler}
  270. // onMarkdownHelpButtonClicked={() => { setIsCheatsheetModalShown(true) }}
  271. // onAddAttachmentButtonClicked={addAttachmentHandler}
  272. // editorSettings={editorSettings}
  273. // isGfmMode={isGfmMode}
  274. // {...props}
  275. // />
  276. <></>
  277. )}
  278. {/* for mobile */}
  279. { isMobile && (
  280. <TextAreaEditor
  281. ref={taEditorRef}
  282. onPasteFiles={pasteFilesHandler}
  283. onDragEnter={dragEnterHandler}
  284. {...props}
  285. />
  286. )}
  287. <input {...getInputProps()} />
  288. </div>
  289. );
  290. }}
  291. </Dropzone>
  292. { isUploadable
  293. && (
  294. <button
  295. type="button"
  296. className="btn btn-outline-secondary btn-open-dropzone"
  297. onClick={addAttachmentHandler}
  298. >
  299. <span className="material-symbols-outlined" aria-hidden="true">attachment</span>&nbsp;
  300. Attach files
  301. <span className="d-none d-sm-inline">
  302. &nbsp;by dragging &amp; dropping,&nbsp;
  303. <span className="btn-link">selecting them</span>,&nbsp;
  304. or pasting from the clipboard.
  305. </span>
  306. </button>
  307. )
  308. }
  309. { renderCheatsheetModal() }
  310. </div>
  311. </>
  312. );
  313. };
  314. export default memo(forwardRef(Editor));