Files
persionalBrand/apps/admin/src/features/brand/ComponentTemplatePreview.tsx
T

278 lines
11 KiB
TypeScript

import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
import type { RuntimeWorkspace } from "@personal-brand/api-client";
import { Alert } from "antd";
import { resolveTemplateRenderer } from "./component-renderers.jsx";
import type { PreviewSelection, PreviewTarget } from "./preview-selection.js";
import { TemplatePreviewAssetsContext } from "./preview-assets.js";
import "./ComponentTemplatePreview.css";
type PreviewProps = {
workspace: RuntimeWorkspace;
page: string;
offeringId?: string;
assetFiles?: Record<string, { sha256: string; dataUrl: string }>;
selection?: PreviewSelection;
targets: PreviewTarget[];
onTargetSelected: (selection?: PreviewSelection) => void;
onPageSelected?: (page: string) => void;
onOfferingSelected?: (offeringId: string) => void;
};
type Outline = { top: number; left: number; width: number; height: number; label: string };
type CompositeOutline = Outline & { key: string };
export function ComponentTemplatePreview({
workspace,
page,
offeringId,
assetFiles,
selection,
targets,
onTargetSelected,
onPageSelected = () => undefined,
onOfferingSelected = () => undefined,
}: PreviewProps) {
const Renderer = resolveTemplateRenderer(workspace);
const root = useRef<HTMLDivElement>(null);
const canvas = useRef<HTMLDivElement>(null);
const [mode, setMode] = useState<"edit" | "browse">("edit");
const [hovered, setHovered] = useState<HTMLElement | null>(null);
const overlay = useRef<HTMLDivElement>(null);
// 将 renderer 里的 Taro CTA 导航转换为画布内页面/记录切换。
useEffect(() => {
const navigate = (event: Event) => {
const detail = (event as CustomEvent<{ method?: string; options?: { url?: string } }>).detail;
const url = detail?.options?.url;
if (typeof url !== "string") return;
const match = /^\/pages\/([a-z]+)\/index(?:\?(.*))?$/.exec(url);
if (!match) return;
const nextPage = match[1];
if (!nextPage) return;
const query = match[2];
if (nextPage === "detail") {
const id = new URLSearchParams(query ?? "").get("id");
if (id) onOfferingSelected(id);
}
onPageSelected(nextPage);
};
window.addEventListener("template-preview-navigate", navigate);
return () => window.removeEventListener("template-preview-navigate", navigate);
}, [onOfferingSelected, onPageSelected]);
const targetFor = useCallback(
(element: Element | null): HTMLElement | null => {
let candidate = element?.closest<HTMLElement>("[data-editor-target]");
let deepest: HTMLElement | null = null;
let composite: HTMLElement | null = null;
while (candidate && root.current?.contains(candidate)) {
const target = targets.find((item) => item.key === candidate?.dataset.editorTarget);
if (target && !deepest) deepest = candidate;
if (target?.composite) composite = candidate;
candidate = candidate.parentElement?.closest<HTMLElement>("[data-editor-target]") ?? null;
}
return deepest ?? composite;
},
[targets],
);
const selectedElement = useCallback(() => {
if (!selection) return null;
return (
Array.from(root.current?.querySelectorAll<HTMLElement>("[data-editor-target]") ?? []).find(
(element) =>
element.dataset.editorTarget === selection.targetKey &&
(element.dataset.editorRecordId || undefined) === selection.recordId,
) ?? null
);
}, [selection]);
const renderOutlines = useCallback(
(
host: HTMLDivElement,
outlines: {
hover: Outline | null;
selected: Outline | null;
composite: CompositeOutline[];
},
) => {
host.replaceChildren();
const position = (node: HTMLElement, outline: Outline) => {
node.style.top = `${outline.top}px`;
node.style.left = `${outline.left}px`;
node.style.width = `${outline.width}px`;
node.style.height = `${outline.height}px`;
};
if (outlines.hover) {
const node = document.createElement("div");
node.className = "component-template-preview__outline is-hovered";
position(node, outlines.hover);
host.append(node);
}
if (outlines.selected) {
const node = document.createElement("div");
node.className = "component-template-preview__outline is-selected";
node.dataset.selectedTarget = selection?.targetKey ?? "";
node.dataset.selectedRecordId = selection?.recordId ?? "";
const label = document.createElement("span");
label.textContent = outlines.selected.label;
node.append(label);
position(node, outlines.selected);
host.append(node);
}
for (const outline of outlines.composite.filter(
(item) => item.key !== selection?.targetKey,
)) {
const node = document.createElement("button");
node.type = "button";
node.className = "component-template-preview__composite-select";
node.textContent = `选择${outline.label}`;
node.setAttribute("aria-label", node.textContent);
node.onclick = () => onTargetSelected({ targetKey: outline.key });
node.style.top = `${outline.top + 4}px`;
node.style.left = `${outline.left + 4}px`;
host.append(node);
}
},
[onTargetSelected, selection?.recordId, selection?.targetKey],
);
const measure = useCallback(
(element: HTMLElement | null): Outline | null => {
const host = canvas.current;
if (!element || !host || !host.contains(element)) return null;
const box = element.getBoundingClientRect();
const parent = host.getBoundingClientRect();
const target = targets.find((item) => item.key === element.dataset.editorTarget);
if (!target || !box.width || !box.height) return null;
return {
top: box.top - parent.top,
left: box.left - parent.left,
width: box.width,
height: box.height,
label: target.label,
};
},
[targets],
);
useLayoutEffect(() => {
const viewport = root.current;
const outlineHost = overlay.current;
const host = canvas.current;
if (!viewport || !outlineHost || !host) return;
let frame = 0;
const update = () => {
cancelAnimationFrame(frame);
frame = requestAnimationFrame(() => {
const nextHover = measure(hovered);
const nextSelected = measure(selectedElement());
const nextComposite = targets
.filter((target) => target.composite)
.flatMap((target) => {
const element = host.querySelector<HTMLElement>(
`[data-editor-target="${CSS.escape(target.key)}"]`,
);
const outline = measure(element);
return outline ? [{ ...outline, key: target.key }] : [];
});
renderOutlines(outlineHost, {
hover: nextHover,
selected: nextSelected,
composite: nextComposite,
});
});
};
update();
const resize = new ResizeObserver(update);
resize.observe(viewport);
host
.querySelectorAll<HTMLElement>("[data-editor-target]")
.forEach((node) => resize.observe(node));
window.addEventListener("resize", update);
viewport.addEventListener("scroll", update);
viewport.addEventListener("load", update, true);
return () => {
cancelAnimationFrame(frame);
resize.disconnect();
window.removeEventListener("resize", update);
viewport.removeEventListener("scroll", update);
viewport.removeEventListener("load", update, true);
};
}, [hovered, measure, selectedElement, workspace, page]);
useEffect(() => {
selectedElement()?.scrollIntoView({ block: "nearest", behavior: "smooth" });
}, [selectedElement]);
useEffect(() => {
const clear = (event: KeyboardEvent) => {
if (event.key === "Escape") onTargetSelected(undefined);
};
window.addEventListener("keydown", clear);
return () => window.removeEventListener("keydown", clear);
}, [onTargetSelected]);
if (!Renderer)
return <Alert type="warning" showIcon title="此模板尚无组件预览,请使用页面预览" />;
return (
<div className="component-template-preview-shell">
<div
className="component-template-preview__tools"
aria-label="预览操作模式"
hidden={!targets.length}
>
<button type="button" aria-pressed={mode === "edit"} onClick={() => setMode("edit")}>
点选编辑
</button>
<button type="button" aria-pressed={mode === "browse"} onClick={() => setMode("browse")}>
浏览页面
</button>
</div>
<div
ref={root}
className="component-template-preview"
data-active-target={selection?.targetKey}
data-active-record-id={selection?.recordId}
data-editor-mode={mode}
onPointerMoveCapture={(event) => {
if (mode !== "edit" || !targets.length) return;
const next = targetFor(event.target instanceof Element ? event.target : null);
if (next !== hovered) setHovered(next);
}}
onPointerLeave={() => setHovered(null)}
onClickCapture={(event) => {
if (mode !== "edit" || !targets.length) return;
if (event.target instanceof Element && event.target.closest("[data-editor-overlay]")) {
return;
}
const canvas = root.current?.querySelector(".component-template-preview__canvas");
if (!event.target || !(event.target instanceof Node) || !canvas?.contains(event.target))
return;
const pointTarget = document.elementFromPoint(event.clientX, event.clientY);
const element = targetFor(
pointTarget && canvas.contains(pointTarget) ? pointTarget : null,
);
event.preventDefault();
event.stopPropagation();
onTargetSelected(
element
? {
targetKey: element.dataset.editorTarget!,
...(element.dataset.editorRecordId
? { recordId: element.dataset.editorRecordId }
: {}),
}
: undefined,
);
}}
>
<div ref={canvas} className="component-template-preview__canvas">
<TemplatePreviewAssetsContext.Provider value={assetFiles}>
<Renderer workspace={workspace} page={page} {...(offeringId ? { offeringId } : {})} />
</TemplatePreviewAssetsContext.Provider>
<div
ref={overlay}
className={`component-template-preview__overlay-host ${
mode === "edit" ? "is-visible" : ""
}`}
data-editor-overlay=""
/>
</div>
</div>
</div>
);
}
// @ts-nocheck