feat: you can now focus onto pages by pressing '/' from anywhere!

packages/editor/core/src/hooks/use-editor.tsx

@@ -187,6 +187,24 @@ export const useEditor = ({
         scrollSummary(editorRef.current, marking);
       },
       isEditorReadyToDiscard: () => editorRef.current?.storage.image.uploadInProgress === false,
+      isEditorFocused: () => editorRef.current?.isFocused,
+      setFocusAtSavedSelection: () => {
+        if (!editorRef.current || editorRef.current.isDestroyed) {
+          console.error("Editor reference is not available or has been destroyed.");
+          return;
+        }
+        try {
+          let focusPosition = 0;
+          if (savedSelection) {
+            focusPosition = savedSelection.from;
+          }
+          const docSize = editorRef.current.state.doc.content.size;
+          const safePosition = Math.max(0, Math.min(focusPosition, docSize));
+          editorRef.current.chain().focus().setTextSelection(safePosition).run();
+        } catch (error) {
+          console.error("An error occurred while setting focus at position:", error);
+        }
+      },
       setFocusAtPosition: (position: number) => {
         if (!editorRef.current || editorRef.current.isDestroyed) {
           console.error("Editor reference is not available or has been destroyed.");

packages/editor/core/src/types/editor-ref-api.ts

@@ -16,4 +16,6 @@ export interface EditorRefApi extends EditorReadOnlyRefApi {
   onStateChange: (callback: () => void) => () => void;
   setFocusAtPosition: (position: number) => void;
   isEditorReadyToDiscard: () => boolean;
+  isEditorFocused: () => boolean;
+  setFocusAtSavedSelection: () => void;
 }

packages/editor/core/src/ui/extensions/index.tsx

@@ -139,6 +139,9 @@ export const CoreEditorExtensions = ({
   }),
   Placeholder.configure({
     placeholder: ({ editor, node }) => {
+      if (!editor.isFocused && editor.state.doc.content.size === 2) {
+        return "Focus by pressing /";
+      }
       if (node.type.name === "heading") return `Heading ${node.attrs.level}`;
 
       if (editor.storage.image.uploadInProgress) return "";

web/app/[workspaceSlug]/(projects)/projects/(detail)/[projectId]/pages/(detail)/[pageId]/page.tsx

@@ -20,6 +20,7 @@ import { PageEditorBody, PageEditorHeaderRoot } from "@/components/pages";
 import { cn } from "@/helpers/common.helper";
 // hooks
 import { usePage, useProjectPages } from "@/hooks/store";
+import useFocusOnSlash from "@/hooks/use-focus-on-slash";
 
 const PageDetailsPage = observer(() => {
   // states
@@ -29,6 +30,8 @@ const PageDetailsPage = observer(() => {
   // refs
   const editorRef = useRef<EditorRefApi>(null);
   const readOnlyEditorRef = useRef<EditorRefApi>(null);
+  // Use the custom hook to focus on the editor when "/" is pressed
+  useFocusOnSlash(editorRef);
   // router
   const router = useRouter();
   const { workspaceSlug, projectId, pageId } = useParams();

web/core/hooks/use-focus-on-slash.ts

@@ -0,0 +1,23 @@
+import { useEffect } from "react";
+import { EditorRefApi } from "@plane/document-editor";
+
+const useFocusOnSlash = (editorRef: React.RefObject<EditorRefApi>) => {
+  useEffect(() => {
+    const handleKeyDown = (e: KeyboardEvent) => {
+      if (!editorRef.current?.isEditorFocused()) {
+        if (e.key === "/") {
+          e.preventDefault();
+          editorRef.current?.setFocusAtSavedSelection();
+        }
+      }
+    };
+
+    window.addEventListener("keydown", handleKeyDown);
+
+    return () => {
+      window.removeEventListener("keydown", handleKeyDown);
+    };
+  }, [editorRef]);
+};
+
+export default useFocusOnSlash;