278 lines
11 KiB
TypeScript
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
|