Skip to content

Open source website builder and Webflow alternative. Webstudio is an advanced visual builder that connects to any headless CMS, supports all CSS properties, and can be hosted anywhere, including with us.

feat: Explain an empty Content mode Navigator (#6601)

Oleg Isonen9feb53248c0a
diff --git a/apps/builder/app/builder/features/navigator/navigator-empty-state.test.tsx b/apps/builder/app/builder/features/navigator/navigator-empty-state.test.tsx
new file mode 100644
index 0000000000..fefe33f3f7
--- /dev/null
+++ b/apps/builder/app/builder/features/navigator/navigator-empty-state.test.tsx
@@ -0,0 +1,104 @@
+import { act } from "react-dom/test-utils";
+import { createRoot, type Root } from "react-dom/client";
+import { afterEach, expect, test } from "vitest";
+import { createDefaultPages } from "@webstudio-is/project-build";
+import { blockComponent, coreMetas } from "@webstudio-is/sdk";
+import { TooltipProvider } from "@webstudio-is/design-system";
+import {
+ $builderMode,
+ $registeredComponentMetas,
+ $selectedPageId,
+} from "~/shared/nano-states";
+import { $instances, $pages } from "~/shared/sync/data-stores";
+import { NavigatorTree } from "./navigator-tree";
+
+(
+ globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }
+).IS_REACT_ACT_ENVIRONMENT = true;
+
+let root: Root | undefined;
+let container: HTMLDivElement | undefined;
+const previousMetas = $registeredComponentMetas.get();
+
+afterEach(() => {
+ act(() => root?.unmount());
+ container?.remove();
+ root = undefined;
+ container = undefined;
+ $builderMode.set("design");
+ $selectedPageId.set(undefined);
+ $pages.set(undefined);
+ $instances.set(new Map());
+ $registeredComponentMetas.set(previousMetas);
+});
+
+test("explains an empty Content mode Navigator only for a selected page", () => {
+ $registeredComponentMetas.set(new Map(Object.entries(coreMetas)));
+ $pages.set(
+ createDefaultPages({ rootInstanceId: "body", homePageId: "home" })
+ );
+ $instances.set(
+ new Map([
+ [
+ "body",
+ {
+ type: "instance",
+ id: "body",
+ component: "Body",
+ children: [],
+ },
+ ],
+ [
+ "block",
+ {
+ type: "instance",
+ id: "block",
+ component: blockComponent,
+ children: [],
+ },
+ ],
+ ])
+ );
+ container = document.createElement("div");
+ document.body.appendChild(container);
+ root = createRoot(container);
+
+ act(() => {
+ $builderMode.set("content");
+ root?.render(
+ <TooltipProvider>
+ <NavigatorTree />
+ </TooltipProvider>
+ );
+ });
+ expect(container.querySelector('[role="status"]')).toBeNull();
+
+ act(() => $selectedPageId.set("home"));
+ expect(container.querySelector('[role="status"]')).not.toBeNull();
+
+ act(() => {
+ $instances.set(
+ new Map([
+ [
+ "body",
+ {
+ ...$instances.get().get("body")!,
+ children: [{ type: "id", value: "block" }],
+ },
+ ],
+ ["block", $instances.get().get("block")!],
+ ])
+ );
+ });
+ expect(container.querySelector('[role="status"]')).toBeNull();
+
+ act(() => $builderMode.set("design"));
+ expect(container.querySelector('[role="status"]')).toBeNull();
+
+ act(() => {
+ const instances = new Map($instances.get());
+ instances.set("body", { ...instances.get("body")!, children: [] });
+ $instances.set(instances);
+ });
+ expect(container.querySelector('[role="status"]')).toBeNull();
+});
diff --git a/apps/builder/app/builder/features/navigator/navigator-tree.tsx b/apps/builder/app/builder/features/navigator/navigator-tree.tsx
index 793fad73c1..9dd8aadfcc 100644
--- a/apps/builder/app/builder/features/navigator/navigator-tree.tsx
+++ b/apps/builder/app/builder/features/navigator/navigator-tree.tsx
@@ -13,6 +13,7 @@ import {
DropdownMenuItem,
DropdownMenuTrigger,
InfoTooltip,
+ PanelBanner,
cssVar,
keyframes,
ScrollArea,
@@ -855,6 +856,7 @@ const commitNavigatorDrop = ({
export const NavigatorTree = () => {
const isContentMode = useStore($isContentMode);
+ const selectedPage = useStore($selectedPage);
const flatTree = useStore($flatTree);
const externalContentRoots = useStore($externalContentRoots);
const selectedInstanceSelectors = useStore($allSelectedInstanceSelectors);
@@ -1108,6 +1110,17 @@ export const NavigatorTree = () => {
>
<TreeRoot>
<Box data-navigator-tree>
+ {isContentMode &&
+ selectedPage !== undefined &&
+ flatTree.length === 0 && (
+ <PanelBanner variant="warning" role="status">
+ <Text>
+ This page has no editable content. To make areas editable in
+ content mode, wrap them in a Content block component in design
+ mode.
+ </Text>
+ </PanelBanner>
+ )}
{rootMeta && isContentMode === false && (
<TreeNode
level={0}