Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

7.5 KB
Raw Blame
/* 在一张图上框一块。头像和封面共用这一份。
 *
 * 不引裁剪库:要的就是「一个能拖能缩的矩形」,算术全在 `crop-geometry.ts` 里,
 * 画面是一张图加五个绝对定位的块。引一个库进来换到的只有把手样式,代价是一条
 * 新依赖和一套它自己的坐标约定。
 *
 * 框的坐标一律是**源图像素**,进出这一层时各换算一次;屏幕上量到的显示像素不
 * 往外传。确认之后由后端按同一组整数裁,两边不会各取各的整。
 */
import { useCallback, useEffect, useRef, useState } from 'react';
import type {
  CSSProperties, PointerEvent as ReactPointerEvent, KeyboardEvent as ReactKeyboardEvent,
} from 'react';

import {
  boxPercent, clampBox, handleOutside, isUsableSize, moveBox, resizeFromCorner, scaleBox, toNatural,
  type CropBox, type CropSize,
} from '../../crop-geometry';

export interface CropFrameProps {
  src: string;
  /** 宽/高。给了就锁比例,拖动只改位置和大小、不改形状。 */
  aspect: number | null;
  box: CropBox | null;
  size: CropSize | null;
  onBox(box: CropBox): void;
  onSize(size: CropSize): void;
  /** 无障碍名称,说清在框哪张图的哪一块。 */
  label: string;
}

/** 键盘一步走框宽的这个比例。一屏之内按住方向键能从一边走到另一边,又不至于
 *  一下越过一张脸。 */
const KEY_STEP = 0.02;
/** 滚轮一格缩放的倍率。 */
const WHEEL_STEP = 1.08;

export function CropFrame({ src, aspect, box, size, onBox, onSize, label }: CropFrameProps) {
  const image = useRef<HTMLImageElement>(null);
  const drag = useRef<{ mode: 'move' | 'resize'; x: number; y: number; box: CropBox } | null>(null);
  const [failed, setFailed] = useState(false);
  /* 图当前的显示尺寸,只用来判断框在屏幕上够不够大、角柄放框里还是框外。 */
  const [shown, setShown] = useState<CropSize | null>(null);

  useEffect(() => { setFailed(false) }, [src]);
  useEffect(() => {
    const node = image.current;
    if (!node) return undefined;
    const observer = new ResizeObserver(() => setShown({ width: node.clientWidth, height: node.clientHeight }));
    observer.observe(node);
    return () => observer.disconnect();
  }, []);

  /** 显示像素的位移 → 源图像素。图片按 `max-w-full` 缩放,两个轴的比例一样。 */
  const scale = useCallback((dx: number, dy: number) => {
    const node = image.current;
    if (!node || !size) return { dx: 0, dy: 0 };
    return {
      dx: toNatural(dx, node.clientWidth, size.width),
      dy: toNatural(dy, node.clientHeight, size.height),
    };
  }, [size]);

  function start(mode: 'move' | 'resize') {
    return (event: ReactPointerEvent) => {
      if (!box || !size || event.button !== 0) return;
      event.preventDefault();
      event.stopPropagation();
      event.currentTarget.setPointerCapture(event.pointerId);
      drag.current = { mode, x: event.clientX, y: event.clientY, box };
    };
  }

  function move(event: ReactPointerEvent) {
    const active = drag.current;
    const node = image.current;
    if (!active || !node || !size) return;
    const shift = scale(event.clientX - active.x, event.clientY - active.y);
    if (active.mode === 'move') {
      onBox(moveBox(active.box, shift.dx, shift.dy, size));
      return;
    }
    onBox(resizeFromCorner(active.box, active.box.x0 + (active.box.x1 - active.box.x0) + shift.dx,
      active.box.y0 + (active.box.y1 - active.box.y0) + shift.dy, size, aspect));
  }

  function end(event: ReactPointerEvent) {
    if (!drag.current) return;
    drag.current = null;
    if (event.currentTarget.hasPointerCapture(event.pointerId)) {
      event.currentTarget.releasePointerCapture(event.pointerId);
    }
  }

  function keys(event: ReactKeyboardEvent) {
    if (!box || !size) return;
    const step = Math.max(1, (box.x1 - box.x0) * KEY_STEP);
    const moves: Record<string, [number, number]> = {
      ArrowLeft: [-step, 0], ArrowRight: [step, 0], ArrowUp: [0, -step], ArrowDown: [0, step],
    };
    if (moves[event.key]) {
      event.preventDefault();
      onBox(moveBox(box, moves[event.key][0], moves[event.key][1], size));
      return;
    }
    if (event.key === '+' || event.key === '=' || event.key === '-') {
      event.preventDefault();
      onBox(scaleBox(box, event.key === '-' ? 1 / WHEEL_STEP : WHEEL_STEP, size, aspect));
    }
  }

  const rect = box && size ? boxPercent(clampBox(box, size, aspect), size) : null;
  const outside = rect ? handleOutside(rect, shown) : false;
  /* 位置只经自定义属性进 CSS:六个百分数挂在容器上,压暗块与框本身各自用类名取用,
     样式仍然全在类里(`docs/FRONTEND.md`)。 */
  const frame = rect ? {
    '--crop-l': `${rect.left}%`, '--crop-t': `${rect.top}%`,
    '--crop-w': `${rect.width}%`, '--crop-h': `${rect.height}%`,
    '--crop-r': `${rect.left + rect.width}%`, '--crop-b': `${rect.top + rect.height}%`,
  } as CSSProperties : undefined;
  return (
    <div className="relative inline-block max-w-full select-none" style={frame}>
      <img ref={image} src={src} alt="" draggable={false}
        onLoad={(event) => {
          const node = event.currentTarget;
          if (isUsableSize({ width: node.naturalWidth, height: node.naturalHeight })) {
            onSize({ width: node.naturalWidth, height: node.naturalHeight });
          }
        }}
        onError={() => setFailed(true)}
        className="block max-h-crop-frame max-w-full object-contain" />
      {failed || !rect ? null : (
        <>
          {/* 框外压暗。四块而不是一圈巨大的 box-shadow:后者在这一层的圆角与
              overflow 下会溢到弹层外面去。 */}
          <div aria-hidden className="pointer-events-none absolute inset-x-0 top-0 h-(--crop-t) bg-scrim" />
          <div aria-hidden className="pointer-events-none absolute inset-x-0 bottom-0 top-(--crop-b) bg-scrim" />
          <div aria-hidden className="pointer-events-none absolute left-0 top-(--crop-t) h-(--crop-h) w-(--crop-l) bg-scrim" />
          <div aria-hidden className="pointer-events-none absolute right-0 left-(--crop-r) top-(--crop-t) h-(--crop-h) bg-scrim" />
          {/* 框本身。整块可拖,右下角那枚小方块改大小;方向键与加减号做同样两件事。
              框在屏幕上很小(极扁、极长的图)时角柄整枚挪到框外右下,框里留给拖动。 */}
          <div role="group" tabIndex={0} aria-label={label} data-crop-box
            onPointerDown={start('move')} onPointerMove={move}
            onPointerUp={end} onPointerCancel={end} onKeyDown={keys}
            onWheel={(event) => {
              if (!box || !size) return;
              onBox(scaleBox(box, event.deltaY > 0 ? WHEEL_STEP : 1 / WHEEL_STEP, size, aspect));
            }}
            className="absolute left-(--crop-l) top-(--crop-t) h-(--crop-h) w-(--crop-w) cursor-move touch-none outline-none ring-2 ring-border-focus-ring ring-inset focus-visible:ring-4">
            <span data-crop-handle data-outside={outside || undefined} onPointerDown={start('resize')}
              onPointerMove={move} onPointerUp={end} onPointerCancel={end}
              className="absolute -right-1.5 -bottom-1.5 data-outside:-right-3.5 data-outside:-bottom-3.5 size-3 cursor-nwse-resize touch-none rounded-xs border border-separator-border bg-background-full" />
          </div>
        </>
      )}
      {failed
        ? <p className="p-4 text-body-2-regular text-text-secondary">这张图读不出来,换一张再框。</p>
        : null}
    </div>
  );
}