SPB Git

Repository Public

Grid.tsx 7.5 KB 165 lines tsx

1"use client";2import { useLayoutEffect, useRef, useState, type KeyboardEvent, type PointerEvent } from "react";3import { useI18n } from "@/i18n";4import { IconButton, cx } from "@/ui";5import { moveBy, moveTo, resizeBy, resizeTo, type Widget } from "./layout";6import { FrameControls, WidgetView, widgetTitle } from "./widgets";78interface GridProps {9  layout: readonly Widget[];10  editing: boolean;11  compact: boolean;12  onLayout: (next: Widget[]) => void;13  onRemove: (id: string) => void;14  onConfig: (id: string, config: Record<string, unknown>) => void;15  announce: (message: string) => void;16}1718interface DragState {19  id: string;20  mode: "move" | "resize";21  startX: number;22  startY: number;23  base: Widget[];24  origin: Widget;25  colStep: number;26  rowStep: number;27}2829/** Applies the grid placement through the CSSOM (no style attribute in markup: the CSP forbids inline styles). */30function Cell({ widget, editing, children }: { widget: Widget; editing: boolean; children: React.ReactNode }) {31  const ref = useRef<HTMLDivElement>(null);32  useLayoutEffect(() => {33    const el = ref.current;34    if (!el) return;35    el.style.setProperty("--ov-col", `${widget.x + 1} / span ${widget.w}`);36    el.style.setProperty("--ov-row", `${widget.y + 1} / span ${widget.h}`);37  }, [widget.x, widget.y, widget.w, widget.h]);38  return <div ref={ref} className={cx("ov-cell", editing && "editing")} data-widget={widget.id} data-testid={`ov-cell-${widget.id}`} data-x={widget.x} data-y={widget.y} data-w={widget.w} data-h={widget.h}>{children}</div>;39}4041/**42 * 12-column widget grid. In edit mode each widget gets a move handle, a resize handle and a remove button.43 * Pointer: drag a handle. Keyboard: focus the move handle — arrows move, Shift+arrows resize, Esc restores the44 * layout the handle had when it received focus; the resize handle resizes with plain arrows.45 */46export function Grid({ layout, editing, compact, onLayout, onRemove, onConfig, announce }: GridProps) {47  const { t } = useI18n();48  const grid = useRef<HTMLDivElement>(null);49  const drag = useRef<DragState | null>(null);50  const keyboardBase = useRef<Widget[] | null>(null);51  // While a handle is held (focus or pointer), the DOM order is frozen: re-inserting the node of the active52  // handle would drop its focus and its pointer capture. Reading order is restored as soon as it is released.53  const [frozen, setFrozen] = useState<string[] | null>(null);54  const freeze = () => setFrozen((f) => f ?? layout.map((w) => w.id));55  const rendered = frozen ? [...layout].sort((a, b) => (frozen.indexOf(a.id) + 1 || 1e6) - (frozen.indexOf(b.id) + 1 || 1e6)) : layout;5657  const describe = (next: readonly Widget[], id: string, key: "moved" | "resized") => {58    const w = next.find((x) => x.id === id);59    if (w) announce(t(`overview.edit.${key}`, { title: widgetTitle(t, w), column: w.x + 1, row: w.y + 1, width: w.w, height: w.h }));60  };6162  const onPointerDown = (e: PointerEvent<HTMLButtonElement>, id: string, mode: "move" | "resize") => {63    const el = grid.current;64    const origin = layout.find((w) => w.id === id);65    if (!el || !origin || e.button !== 0) return;66    const cs = getComputedStyle(el);67    if (cs.getPropertyValue("--ov-single").trim() === "1") return; // single-column (narrow) layout: keyboard / buttons only68    const gap = parseFloat(cs.columnGap) || 0;69    const rowUnit = parseFloat(cs.gridAutoRows) || 80;70    freeze();71    e.currentTarget.setPointerCapture(e.pointerId);72    drag.current = { id, mode, startX: e.clientX, startY: e.clientY, base: [...layout], origin, colStep: (el.getBoundingClientRect().width + gap) / 12, rowStep: rowUnit + gap };73  };74  const onPointerMove = (e: PointerEvent<HTMLButtonElement>) => {75    const d = drag.current;76    if (!d) return;77    const dx = Math.round((e.clientX - d.startX) / d.colStep);78    const dy = Math.round((e.clientY - d.startY) / d.rowStep);79    onLayout(d.mode === "move" ? moveTo(d.base, d.id, d.origin.x + dx, d.origin.y + dy) : resizeTo(d.base, d.id, d.origin.w + dx, d.origin.h + dy));80  };81  const endDrag = (e: PointerEvent<HTMLButtonElement>, cancel: boolean) => {82    const d = drag.current;83    if (!d) return;84    drag.current = null;85    if (e.currentTarget.hasPointerCapture(e.pointerId)) e.currentTarget.releasePointerCapture(e.pointerId);86    if (document.activeElement !== e.currentTarget) setFrozen(null);87    if (cancel) onLayout(d.base);88    else describe(layout, d.id, d.mode === "move" ? "moved" : "resized");89  };9091  const onKey = (e: KeyboardEvent<HTMLButtonElement>, id: string, handle: "move" | "resize") => {92    const dir: Record<string, [number, number]> = { ArrowLeft: [-1, 0], ArrowRight: [1, 0], ArrowUp: [0, -1], ArrowDown: [0, 1] };93    if (e.key === "Escape") {94      if (drag.current) {95        e.preventDefault();96        e.stopPropagation();97        const base = drag.current.base;98        drag.current = null;99        onLayout(base);100      } else if (keyboardBase.current) {101        e.preventDefault();102        e.stopPropagation();103        onLayout(keyboardBase.current);104        announce(t("overview.edit.cancelled"));105      }106      return;107    }108    const d = dir[e.key];109    if (!d) return;110    e.preventDefault();111    const resize = handle === "resize" || e.shiftKey;112    const next = resize ? resizeBy(layout, id, d[0], d[1]) : moveBy(layout, id, d[0], d[1]);113    onLayout(next);114    describe(next, id, resize ? "resized" : "moved");115  };116117  return (118    <div ref={grid} className={cx("ov-grid", compact && "compact", editing && "editing")} data-testid="ov-grid">119      {rendered.map((w) => {120        const title = widgetTitle(t, w);121        const controls = editing ? (122          <span className="ov-controls">123            <IconButton124              icon="drag" size="sm" tip={false}125              label={t("overview.edit.moveHandle", { title, column: w.x + 1, row: w.y + 1 })}126              aria-describedby="ov-edit-help"127              data-testid={`ov-move-${w.id}`}128              data-handle="move"129              onFocus={() => { keyboardBase.current = [...layout]; freeze(); }}130              onBlur={() => { keyboardBase.current = null; setFrozen(null); }}131              onKeyDown={(e) => onKey(e, w.id, "move")}132              onPointerDown={(e) => onPointerDown(e, w.id, "move")}133              onPointerMove={onPointerMove}134              onPointerUp={(e) => endDrag(e, false)}135              onPointerCancel={(e) => endDrag(e, true)}136            />137            <IconButton138              icon="expand" size="sm" tip={false}139              label={t("overview.edit.resizeHandle", { title, width: w.w, height: w.h })}140              aria-describedby="ov-edit-help"141              data-testid={`ov-resize-${w.id}`}142              data-handle="resize"143              onFocus={() => { keyboardBase.current = [...layout]; freeze(); }}144              onBlur={() => { keyboardBase.current = null; setFrozen(null); }}145              onKeyDown={(e) => onKey(e, w.id, "resize")}146              onPointerDown={(e) => onPointerDown(e, w.id, "resize")}147              onPointerMove={onPointerMove}148              onPointerUp={(e) => endDrag(e, false)}149              onPointerCancel={(e) => endDrag(e, true)}150            />151            <IconButton icon="close" size="sm" tip={false} label={t("overview.edit.remove", { title })} data-testid={`ov-remove-${w.id}`} onClick={() => onRemove(w.id)} />152          </span>153        ) : null;154        return (155          <Cell key={w.id} widget={w} editing={editing}>156            <FrameControls.Provider value={controls}>157              <WidgetView widget={w} onConfig={(config) => onConfig(w.id, config)} />158            </FrameControls.Provider>159          </Cell>160        );161      })}162    </div>163  );164}165
Files main
Menu

Theme