Editor.tsx 10.0 KB

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