add editor config menu to markdown toolbar

Author: haschek

src/extensions/codemirror/toolbars/EditorAppearanceConfigMenu.tsx

@@ -0,0 +1,59 @@
+import React from "react";
+
+import { ContextMenu, ContextMenuProps, MenuItem } from "../../../components";
+
+export interface EditorAppearanceConfigMenuProps {
+    /** Object containing a `true`/`false` value for each property */
+    config: { [s: string]: boolean };
+    /** Object containing `true` for each property that cannot be changed by user */
+    configLocked?: { [s: string]: boolean | undefined };
+    /** Handler that returns a translation for each config property key */
+    configPropertyTranslate?: (key: string) => string | false;
+    /** Handler to update config after user changes */
+    setConfig: React.Dispatch<React.SetStateAction<{ [s: string]: boolean }>>;
+    /** Additional properties used for the included `ContextMenu` */
+    contextMenuProps?: ContextMenuProps;
+}
+
+/**
+ * Returns a simple context menu that provides switches to control the editor appearance.
+ */
+export function EditorAppearanceConfigMenu({
+    config,
+    configLocked = {},
+    configPropertyTranslate = (s) => s,
+    setConfig,
+    contextMenuProps,
+}: EditorAppearanceConfigMenuProps) {
+    return (
+        <ContextMenu
+            togglerElement={"item-settings"}
+            {...contextMenuProps}
+            disabled={
+                contextMenuProps?.disabled ??
+                Object.values(config).length ===
+                    Object.values(configLocked).filter((value) => {
+                        return typeof value !== "undefined";
+                    }).length
+            }
+        >
+            {Object.entries(config).map(([key, value]) => {
+                return (
+                    <MenuItem
+                        key={key}
+                        roleStructure={"listoption"}
+                        selected={value}
+                        text={configPropertyTranslate(key) || key}
+                        disabled={typeof configLocked[key] !== "undefined"}
+                        onClick={() => {
+                            setConfig({
+                                ...config,
+                                [key]: !value,
+                            });
+                        }}
+                    />
+                );
+            })}
+        </ContextMenu>
+    );
+}

src/extensions/codemirror/toolbars/markdown.toolbar.tsx

@@ -9,6 +9,7 @@ import { Spacing } from "../../../components/Separation/Spacing";
 import { Toolbar, ToolbarSection } from "../../../components/Toolbar";
 
 import MarkdownCommand from "./commands/markdown.command";
+import { EditorAppearanceConfigMenu } from "./EditorAppearanceConfigMenu";
 
 interface MarkdownToolbarProps {
     view?: EditorView;
@@ -17,6 +18,7 @@ interface MarkdownToolbarProps {
     translate: (key: string) => string | false;
     disabled?: boolean;
     readonly?: boolean;
+    configMenu?: React.ReactElement<typeof EditorAppearanceConfigMenu>;
 }
 
 export const MarkdownToolbar: React.FC<MarkdownToolbarProps> = ({
@@ -25,7 +27,8 @@ export const MarkdownToolbar: React.FC<MarkdownToolbarProps> = ({
     showPreview,
     disabled,
     readonly,
-    translate
+    translate,
+    configMenu,
 }) => {
     const commandRef = React.useRef<MarkdownCommand | null>(null);
 
@@ -35,10 +38,10 @@ export const MarkdownToolbar: React.FC<MarkdownToolbarProps> = ({
         }
     }, [view]);
 
-    const getTranslation = (fallback: string) : string => {
+    const getTranslation = (fallback: string): string => {
         const key = fallback.toLowerCase().replace(" ", "-");
         return translate(key) || fallback;
-    }
+    };
 
     const { basic, lists, attachments } = MarkdownCommand.commands;
     return (
@@ -112,6 +115,17 @@ export const MarkdownToolbar: React.FC<MarkdownToolbarProps> = ({
                     disabled={disabled}
                 />
             </ToolbarSection>
+            {configMenu && (
+                <ToolbarSection>
+                    <Spacing vertical size="small" hasDivider />
+                    {React.cloneElement(configMenu, {
+                        ...{
+                            ...configMenu.props,
+                            contextMenuProps: { disabled: showPreview || disabled ? true : undefined },
+                        },
+                    })}
+                </ToolbarSection>
+            )}
         </Toolbar>
     );
 };