editor_page.dart 13 KB

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