Editor.tsx 10 KB

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