Editor.tsx 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365
  1. import React, {
  2. useState, useRef, useImperativeHandle, useCallback, ForwardRefRenderFunction, forwardRef,
  3. memo,
  4. useEffect,
  5. } from 'react';
  6. import Dropzone from 'react-dropzone';
  7. import { useTranslation } from 'react-i18next';
  8. import {
  9. Modal, ModalHeader, ModalBody,
  10. } from 'reactstrap';
  11. import { toastError, toastSuccess } from '~/client/util/apiNotification';
  12. import { IEditorSettings } from '~/interfaces/editor-settings';
  13. import { useDefaultIndentSize } from '~/stores/context';
  14. import { useEditorSettings } from '~/stores/editor';
  15. import { useIsMobile } from '~/stores/ui';
  16. import { IEditorMethods } from '../../interfaces/editor-methods';
  17. import AbstractEditor from './AbstractEditor';
  18. import { Cheatsheet } from './Cheatsheet';
  19. import CodeMirrorEditor from './CodeMirrorEditor';
  20. import pasteHelper from './PasteHelper';
  21. import TextAreaEditor from './TextAreaEditor';
  22. import styles from './Editor.module.scss';
  23. export type EditorPropsType = {
  24. value?: string,
  25. isGfmMode?: boolean,
  26. noCdn?: boolean,
  27. isUploadable?: boolean,
  28. isUploadableFile?: boolean,
  29. isTextlintEnabled?: 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, isUploadableFile, 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 (!isUploadableFile) {
  109. accept = 'image/*'; // image only
  110. }
  111. else {
  112. accept = ''; // allow all
  113. }
  114. }
  115. return accept;
  116. }, [isUploadable, isUploadableFile]);
  117. const pasteFilesHandler = useCallback((event) => {
  118. const items = event.clipboardData.items || event.clipboardData.files || [];
  119. toastSuccess(t('toaster.file_upload_succeeded'));
  120. // abort if length is not 1
  121. if (items.length < 1) {
  122. return;
  123. }
  124. for (let i = 0; i < items.length; i++) {
  125. try {
  126. const file = items[i].getAsFile();
  127. // check file type (the same process as Dropzone)
  128. if (file != null && pasteHelper.isAcceptableType(file, getAcceptableType())) {
  129. dispatchUpload(file);
  130. setIsUploading(true);
  131. }
  132. }
  133. catch (e) {
  134. toastError(t('toaster.file_upload_failed'));
  135. }
  136. }
  137. }, [dispatchUpload, getAcceptableType, t]);
  138. const dragEnterHandler = useCallback((event) => {
  139. const dataTransfer = event.dataTransfer;
  140. // do nothing if contents is not files
  141. if (!dataTransfer.types.includes('Files')) {
  142. return;
  143. }
  144. setDropzoneActive(true);
  145. }, []);
  146. const dropHandler = useCallback((accepted) => {
  147. // rejected
  148. if (accepted.length !== 1) { // length should be 0 or 1 because `multiple={false}` is set
  149. setDropzoneActive(false);
  150. return;
  151. }
  152. const file = accepted[0];
  153. dispatchUpload(file);
  154. setIsUploading(true);
  155. }, [dispatchUpload]);
  156. const addAttachmentHandler = useCallback(() => {
  157. if (dropzoneRef.current == null) { return }
  158. dropzoneRef.current.open();
  159. }, []);
  160. const getDropzoneClassName = useCallback((isDragAccept: boolean, isDragReject: boolean) => {
  161. let className = 'dropzone';
  162. if (!isUploadable) {
  163. className += ' dropzone-unuploadable';
  164. }
  165. else {
  166. className += ' dropzone-uploadable';
  167. if (isUploadableFile) {
  168. className += ' dropzone-uploadablefile';
  169. }
  170. }
  171. // uploading
  172. if (isUploading) {
  173. className += ' dropzone-uploading';
  174. }
  175. if (isDragAccept) {
  176. className += ' dropzone-accepted';
  177. }
  178. if (isDragReject) {
  179. className += ' dropzone-rejected';
  180. }
  181. return className;
  182. }, [isUploadable, isUploading, isUploadableFile]);
  183. const renderDropzoneOverlay = useCallback(() => {
  184. return (
  185. <div className="overlay overlay-dropzone-active">
  186. {isUploading
  187. && (
  188. <span className="overlay-content">
  189. <div className="speeding-wheel d-inline-block"></div>
  190. <span className="sr-only">Uploading...</span>
  191. </span>
  192. )
  193. }
  194. {!isUploading && <span className="overlay-content"></span>}
  195. </div>
  196. );
  197. }, [isUploading]);
  198. const renderNavbar = () => {
  199. return (
  200. <div className="m-0 navbar navbar-default navbar-editor" data-testid="navbar-editor" style={{ minHeight: 'unset' }}>
  201. <ul className="pl-2 nav nav-navbar">
  202. { navBarItems.map((item, idx) => {
  203. // eslint-disable-next-line react/no-array-index-key
  204. return <li key={`navbarItem-${idx}`}>{item}</li>;
  205. }) }
  206. </ul>
  207. </div>
  208. );
  209. };
  210. const renderCheatsheetModal = useCallback(() => {
  211. const hideCheatsheetModal = () => {
  212. setIsCheatsheetModalShown(false);
  213. };
  214. return (
  215. <Modal isOpen={isCheatsheetModalShown} toggle={hideCheatsheetModal} className={`modal-gfm-cheatsheet ${styles['modal-gfm-cheatsheet']}`} size={'lg'} >
  216. <ModalHeader tag="h4" toggle={hideCheatsheetModal} className="bg-primary text-light">
  217. <i className="icon-fw icon-question" />Markdown help
  218. </ModalHeader>
  219. <ModalBody>
  220. <Cheatsheet />
  221. </ModalBody>
  222. </Modal>
  223. );
  224. }, [isCheatsheetModalShown]);
  225. const isReadyToRenderEditor = editorSettings != null;
  226. // https://redmine.weseek.co.jp/issues/111731
  227. useEffect(() => {
  228. const editorRef = editorSubstance();
  229. if (isReadyToRenderEditor && editorRef != null) {
  230. const editorNavBarItems = editorRef.getNavbarItems() ?? [];
  231. setNavBarItems(editorNavBarItems);
  232. }
  233. }, [editorSubstance, isReadyToRenderEditor]);
  234. if (!isReadyToRenderEditor) {
  235. return <></>;
  236. }
  237. const flexContainer: React.CSSProperties = {
  238. height: '100%',
  239. display: 'flex',
  240. flexDirection: 'column',
  241. };
  242. return (
  243. <>
  244. <div style={flexContainer} className={`editor-container ${styles['editor-container']}`} >
  245. <Dropzone
  246. ref={dropzoneRef}
  247. accept={getAcceptableType()}
  248. noClick
  249. noKeyboard
  250. multiple={false}
  251. onDragLeave={() => { setDropzoneActive(false) }}
  252. onDrop={dropHandler}
  253. >
  254. {({
  255. getRootProps,
  256. getInputProps,
  257. isDragAccept,
  258. isDragReject,
  259. }) => {
  260. return (
  261. <div className={getDropzoneClassName(isDragAccept, isDragReject)} {...getRootProps()}>
  262. { dropzoneActive && renderDropzoneOverlay() }
  263. { renderNavbar() }
  264. {/* for PC */}
  265. { !isMobile && (
  266. <CodeMirrorEditor
  267. ref={cmEditorRef}
  268. indentSize={indentSize ?? defaultIndentSize}
  269. onPasteFiles={pasteFilesHandler}
  270. onDragEnter={dragEnterHandler}
  271. onMarkdownHelpButtonClicked={() => { setIsCheatsheetModalShown(true) }}
  272. onAddAttachmentButtonClicked={addAttachmentHandler}
  273. editorSettings={editorSettings}
  274. isGfmMode={isGfmMode}
  275. {...props}
  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-block btn-open-dropzone"
  297. onClick={addAttachmentHandler}
  298. >
  299. <i className="icon-paper-clip" aria-hidden="true"></i>&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));