editor_page.dart 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426
  1. import 'package:appflowy/plugins/document/application/doc_bloc.dart';
  2. import 'package:appflowy/plugins/document/presentation/editor_plugins/inline_page/inline_page_reference.dart';
  3. import 'package:appflowy/plugins/document/presentation/editor_plugins/plugins.dart';
  4. import 'package:appflowy/plugins/document/presentation/editor_style.dart';
  5. import 'package:appflowy/workspace/application/settings/shortcuts/settings_shortcuts_service.dart';
  6. import 'package:appflowy_editor/appflowy_editor.dart';
  7. import 'package:collection/collection.dart';
  8. import 'package:flowy_infra/theme_extension.dart';
  9. import 'package:flowy_infra_ui/flowy_infra_ui.dart';
  10. import 'package:flutter/material.dart';
  11. import 'package:flutter_bloc/flutter_bloc.dart';
  12. /// Wrapper for the appflowy editor.
  13. class AppFlowyEditorPage extends StatefulWidget {
  14. const AppFlowyEditorPage({
  15. super.key,
  16. required this.editorState,
  17. this.header,
  18. this.shrinkWrap = false,
  19. this.scrollController,
  20. this.autoFocus,
  21. required this.styleCustomizer,
  22. });
  23. final Widget? header;
  24. final EditorState editorState;
  25. final ScrollController? scrollController;
  26. final bool shrinkWrap;
  27. final bool? autoFocus;
  28. final EditorStyleCustomizer styleCustomizer;
  29. @override
  30. State<AppFlowyEditorPage> createState() => _AppFlowyEditorPageState();
  31. }
  32. final List<CommandShortcutEvent> commandShortcutEvents = [
  33. ...codeBlockCommands,
  34. ...standardCommandShortcutEvents,
  35. ];
  36. final List<CommandShortcutEvent> defaultCommandShortcutEvents = [
  37. ...commandShortcutEvents.map((e) => e.copyWith()).toList(),
  38. ];
  39. class _AppFlowyEditorPageState extends State<AppFlowyEditorPage> {
  40. late final ScrollController effectiveScrollController;
  41. final inlinePageReferenceService = InlinePageReferenceService();
  42. final List<CommandShortcutEvent> commandShortcutEvents = [
  43. toggleToggleListCommand,
  44. ...codeBlockCommands,
  45. customCopyCommand,
  46. customPasteCommand,
  47. customCutCommand,
  48. ...standardCommandShortcutEvents,
  49. ];
  50. final List<ToolbarItem> toolbarItems = [
  51. smartEditItem,
  52. paragraphItem,
  53. ...headingItems,
  54. ...markdownFormatItems,
  55. quoteItem,
  56. bulletedListItem,
  57. numberedListItem,
  58. inlineMathEquationItem,
  59. linkItem,
  60. buildTextColorItem(),
  61. buildHighlightColorItem(),
  62. ];
  63. late final List<SelectionMenuItem> slashMenuItems;
  64. late final Map<String, BlockComponentBuilder> blockComponentBuilders =
  65. _customAppFlowyBlockComponentBuilders();
  66. List<CharacterShortcutEvent> get characterShortcutEvents => [
  67. // inline page reference list
  68. ...inlinePageReferenceShortcuts,
  69. // code block
  70. ...codeBlockCharacterEvents,
  71. // toggle list
  72. formatGreaterToToggleList,
  73. insertChildNodeInsideToggleList,
  74. // customize the slash menu command
  75. customSlashCommand(
  76. slashMenuItems,
  77. style: styleCustomizer.selectionMenuStyleBuilder(),
  78. ),
  79. ...standardCharacterShortcutEvents
  80. ..removeWhere(
  81. (element) => element == slashCommand,
  82. ), // remove the default slash command.
  83. ];
  84. late final inlinePageReferenceShortcuts = [
  85. inlinePageReferenceService.customPageLinkMenu(
  86. character: '@',
  87. style: styleCustomizer.selectionMenuStyleBuilder(),
  88. ),
  89. // uncomment this to enable the inline page reference list
  90. // inlinePageReferenceService.customPageLinkMenu(
  91. // character: '+',
  92. // style: styleCustomizer.selectionMenuStyleBuilder(),
  93. // ),
  94. ];
  95. late final showSlashMenu = customSlashCommand(
  96. slashMenuItems,
  97. shouldInsertSlash: false,
  98. style: styleCustomizer.selectionMenuStyleBuilder(),
  99. ).handler;
  100. EditorStyleCustomizer get styleCustomizer => widget.styleCustomizer;
  101. DocumentBloc get documentBloc => context.read<DocumentBloc>();
  102. @override
  103. void initState() {
  104. super.initState();
  105. _initializeShortcuts();
  106. indentableBlockTypes.add(ToggleListBlockKeys.type);
  107. convertibleBlockTypes.add(ToggleListBlockKeys.type);
  108. slashMenuItems = _customSlashMenuItems();
  109. effectiveScrollController = widget.scrollController ?? ScrollController();
  110. }
  111. @override
  112. void dispose() {
  113. if (widget.scrollController == null) {
  114. effectiveScrollController.dispose();
  115. }
  116. super.dispose();
  117. }
  118. @override
  119. Widget build(BuildContext context) {
  120. final (bool autoFocus, Selection? selection) =
  121. _computeAutoFocusParameters();
  122. final editor = AppFlowyEditor(
  123. editorState: widget.editorState,
  124. editable: true,
  125. shrinkWrap: widget.shrinkWrap,
  126. scrollController: effectiveScrollController,
  127. // setup the auto focus parameters
  128. autoFocus: widget.autoFocus ?? autoFocus,
  129. focusedSelection: selection,
  130. // setup the theme
  131. editorStyle: styleCustomizer.style(),
  132. // customize the block builder
  133. blockComponentBuilders: blockComponentBuilders,
  134. // customize the shortcuts
  135. characterShortcutEvents: characterShortcutEvents,
  136. commandShortcutEvents: commandShortcutEvents,
  137. contextMenuItems: customContextMenuItems,
  138. header: widget.header,
  139. footer: const VSpace(200),
  140. );
  141. return Center(
  142. child: ConstrainedBox(
  143. constraints: const BoxConstraints(
  144. maxWidth: double.infinity,
  145. maxHeight: double.infinity,
  146. ),
  147. child: FloatingToolbar(
  148. style: styleCustomizer.floatingToolbarStyleBuilder(),
  149. items: toolbarItems,
  150. editorState: widget.editorState,
  151. scrollController: effectiveScrollController,
  152. child: editor,
  153. ),
  154. ),
  155. );
  156. }
  157. Map<String, BlockComponentBuilder> _customAppFlowyBlockComponentBuilders() {
  158. final standardActions = [
  159. OptionAction.delete,
  160. OptionAction.duplicate,
  161. // OptionAction.divider,
  162. // OptionAction.moveUp,
  163. // OptionAction.moveDown,
  164. ];
  165. final calloutBGColor = AFThemeExtension.of(context).calloutBGColor;
  166. final configuration = BlockComponentConfiguration(
  167. padding: (_) => const EdgeInsets.symmetric(vertical: 5.0),
  168. );
  169. final customBlockComponentBuilderMap = {
  170. PageBlockKeys.type: PageBlockComponentBuilder(),
  171. ParagraphBlockKeys.type: TextBlockComponentBuilder(
  172. configuration: configuration,
  173. ),
  174. TodoListBlockKeys.type: TodoListBlockComponentBuilder(
  175. configuration: configuration.copyWith(
  176. placeholderText: (_) => 'To-do',
  177. ),
  178. ),
  179. BulletedListBlockKeys.type: BulletedListBlockComponentBuilder(
  180. configuration: configuration.copyWith(
  181. placeholderText: (_) => 'List',
  182. ),
  183. ),
  184. NumberedListBlockKeys.type: NumberedListBlockComponentBuilder(
  185. configuration: configuration.copyWith(
  186. placeholderText: (_) => 'List',
  187. ),
  188. ),
  189. QuoteBlockKeys.type: QuoteBlockComponentBuilder(
  190. configuration: configuration.copyWith(
  191. placeholderText: (_) => 'Quote',
  192. ),
  193. ),
  194. HeadingBlockKeys.type: HeadingBlockComponentBuilder(
  195. configuration: configuration.copyWith(
  196. padding: (_) => const EdgeInsets.only(top: 12.0, bottom: 4.0),
  197. placeholderText: (node) =>
  198. 'Heading ${node.attributes[HeadingBlockKeys.level]}',
  199. ),
  200. textStyleBuilder: (level) => styleCustomizer.headingStyleBuilder(level),
  201. ),
  202. ImageBlockKeys.type: ImageBlockComponentBuilder(
  203. configuration: configuration,
  204. showMenu: true,
  205. menuBuilder: (node, state) => Positioned(
  206. top: 0,
  207. right: 10,
  208. child: ImageMenu(
  209. node: node,
  210. state: state,
  211. ),
  212. ),
  213. ),
  214. DatabaseBlockKeys.gridType: DatabaseViewBlockComponentBuilder(
  215. configuration: configuration.copyWith(
  216. padding: (_) => const EdgeInsets.symmetric(vertical: 10),
  217. ),
  218. ),
  219. DatabaseBlockKeys.boardType: DatabaseViewBlockComponentBuilder(
  220. configuration: configuration.copyWith(
  221. padding: (_) => const EdgeInsets.symmetric(vertical: 10),
  222. ),
  223. ),
  224. DatabaseBlockKeys.calendarType: DatabaseViewBlockComponentBuilder(
  225. configuration: configuration.copyWith(
  226. padding: (_) => const EdgeInsets.symmetric(vertical: 10),
  227. ),
  228. ),
  229. CalloutBlockKeys.type: CalloutBlockComponentBuilder(
  230. configuration: configuration,
  231. defaultColor: calloutBGColor,
  232. ),
  233. DividerBlockKeys.type: DividerBlockComponentBuilder(
  234. configuration: configuration,
  235. height: 28.0,
  236. ),
  237. MathEquationBlockKeys.type: MathEquationBlockComponentBuilder(
  238. configuration: configuration.copyWith(
  239. padding: (_) => const EdgeInsets.symmetric(vertical: 20),
  240. ),
  241. ),
  242. CodeBlockKeys.type: CodeBlockComponentBuilder(
  243. configuration: configuration.copyWith(
  244. textStyle: (_) => styleCustomizer.codeBlockStyleBuilder(),
  245. placeholderTextStyle: (_) => styleCustomizer.codeBlockStyleBuilder(),
  246. ),
  247. padding: const EdgeInsets.only(
  248. left: 30,
  249. right: 30,
  250. bottom: 36,
  251. ),
  252. ),
  253. AutoCompletionBlockKeys.type: AutoCompletionBlockComponentBuilder(),
  254. SmartEditBlockKeys.type: SmartEditBlockComponentBuilder(),
  255. ToggleListBlockKeys.type: ToggleListBlockComponentBuilder(
  256. configuration: configuration,
  257. ),
  258. OutlineBlockKeys.type: OutlineBlockComponentBuilder(
  259. configuration: configuration.copyWith(
  260. placeholderTextStyle: (_) =>
  261. styleCustomizer.outlineBlockPlaceholderStyleBuilder(),
  262. ),
  263. ),
  264. };
  265. final builders = {
  266. ...standardBlockComponentBuilderMap,
  267. ...customBlockComponentBuilderMap,
  268. };
  269. // customize the action builder. actually, we can customize them in their own builder. Put them here just for convenience.
  270. for (final entry in builders.entries) {
  271. if (entry.key == PageBlockKeys.type) {
  272. continue;
  273. }
  274. final builder = entry.value;
  275. // customize the action builder.
  276. final supportColorBuilderTypes = [
  277. ParagraphBlockKeys.type,
  278. HeadingBlockKeys.type,
  279. BulletedListBlockKeys.type,
  280. NumberedListBlockKeys.type,
  281. QuoteBlockKeys.type,
  282. TodoListBlockKeys.type,
  283. CalloutBlockKeys.type,
  284. OutlineBlockKeys.type,
  285. ToggleListBlockKeys.type,
  286. ];
  287. final supportAlignBuilderType = [
  288. ImageBlockKeys.type,
  289. ];
  290. final colorAction = [
  291. OptionAction.divider,
  292. OptionAction.color,
  293. ];
  294. final alignAction = [
  295. OptionAction.divider,
  296. OptionAction.align,
  297. ];
  298. final List<OptionAction> actions = [
  299. ...standardActions,
  300. if (supportColorBuilderTypes.contains(entry.key)) ...colorAction,
  301. if (supportAlignBuilderType.contains(entry.key)) ...alignAction,
  302. ];
  303. builder.showActions = (_) => true;
  304. builder.actionBuilder = (context, state) {
  305. final top = builder.configuration.padding(context.node).top;
  306. final padding = context.node.type == HeadingBlockKeys.type
  307. ? EdgeInsets.only(top: top + 8.0)
  308. : EdgeInsets.only(top: top + 2.0);
  309. return Padding(
  310. padding: padding,
  311. child: BlockActionList(
  312. blockComponentContext: context,
  313. blockComponentState: state,
  314. editorState: widget.editorState,
  315. actions: actions,
  316. showSlashMenu: () => showSlashMenu(widget.editorState),
  317. ),
  318. );
  319. };
  320. }
  321. return builders;
  322. }
  323. List<SelectionMenuItem> _customSlashMenuItems() {
  324. final items = [...standardSelectionMenuItems];
  325. final imageItem = items.firstWhereOrNull(
  326. (element) => element.name == AppFlowyEditorLocalizations.current.image,
  327. );
  328. if (imageItem != null) {
  329. final imageItemIndex = items.indexOf(imageItem);
  330. if (imageItemIndex != -1) {
  331. items[imageItemIndex] = customImageMenuItem;
  332. }
  333. }
  334. return [
  335. ...items,
  336. inlineGridMenuItem(documentBloc),
  337. referencedGridMenuItem,
  338. inlineBoardMenuItem(documentBloc),
  339. referencedBoardMenuItem,
  340. inlineCalendarMenuItem(documentBloc),
  341. referencedCalendarMenuItem,
  342. calloutItem,
  343. outlineItem,
  344. mathEquationItem,
  345. codeBlockItem,
  346. toggleListBlockItem,
  347. emojiMenuItem,
  348. autoGeneratorMenuItem,
  349. ];
  350. }
  351. (bool, Selection?) _computeAutoFocusParameters() {
  352. if (widget.editorState.document.isEmpty) {
  353. return (
  354. true,
  355. Selection.collapsed(
  356. Position(path: [0], offset: 0),
  357. ),
  358. );
  359. }
  360. final nodes = widget.editorState.document.root.children
  361. .where((element) => element.delta != null);
  362. final isAllEmpty =
  363. nodes.isNotEmpty && nodes.every((element) => element.delta!.isEmpty);
  364. if (isAllEmpty) {
  365. return (
  366. true,
  367. Selection.collapsed(
  368. Position(path: nodes.first.path, offset: 0),
  369. )
  370. );
  371. }
  372. return const (false, null);
  373. }
  374. Future<void> _initializeShortcuts() async {
  375. //TODO(Xazin): Refactor lazy initialization
  376. defaultCommandShortcutEvents;
  377. final settingsShortcutService = SettingsShortcutService();
  378. final customizeShortcuts =
  379. await settingsShortcutService.getCustomizeShortcuts();
  380. await settingsShortcutService.updateCommandShortcuts(
  381. standardCommandShortcutEvents,
  382. customizeShortcuts,
  383. );
  384. }
  385. }