Editor.tsx 9.9 KB

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