Skip to content

armgit / peach

Public Imported from GitHub
0

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

7.2 KB
Raw Blame
/* 资料卡上那几枚进顶层的浮层:别名与标签的「+N」,以及订阅新作的说明。
 *
 * 三者都是原生 `popover="manual"`:进顶层才不被资料卡的 `overflow:hidden` 裁掉,也不被卡底
 * 同台艺人那条压住。位置按视口算:默认贴锚点下方 8px,下面放不下翻到上方,左右夹在视口内
 * 8px;开着的时候页面滚动或窗口改宽就重算,收起后那条监听自己摘掉。 */
import { useEffect, useRef, useState, type ReactNode, type RefObject } from 'react';

import { Glyph } from './glyph';

/** 把 `pop` 摆到 `anchor` 下方,放不下翻上方,左右夹在视口内 8px。两边都放不下时摆到空间大的
 *  那一边,高度压到那一边真正剩下的空间、浮层里自己滚:浮层从不横跨锚点,盖住「+N」那一下
 *  指针就落在浮层上,按钮再也点不到。 */
export function placePop(anchor: Element, pop: HTMLElement): void {
  pop.style.removeProperty('max-height');
  const at = anchor.getBoundingClientRect(), box = pop.getBoundingClientRect();
  pop.style.left = `${Math.max(8, Math.min(innerWidth - box.width - 8, at.left))}px`;
  const below = at.bottom + 8;
  const roomBelow = innerHeight - 8 - below, roomAbove = at.top - 16;
  const downward = box.height <= roomBelow || (box.height > roomAbove && roomBelow >= roomAbove);
  const room = Math.max(0, downward ? roomBelow : roomAbove);
  if (box.height > room) pop.style.maxHeight = `${room}px`;
  pop.style.top = `${downward ? below : at.top - 8 - Math.min(box.height, room)}px`;
}

const isOpen = (pop: HTMLElement | null) => !!pop?.isConnected && pop.matches(':popover-open');

/** 开着时跟着滚动与改窗宽重算位置;`open` 为假或卸载时摘掉监听。 */
function useFollow(open: boolean, anchor: RefObject<Element | null>, pop: RefObject<HTMLElement | null>, onLost: () => void) {
  const lost = useRef(onLost);
  lost.current = onLost;
  useEffect(() => {
    if (!open) return undefined;
    const follow = () => {
      if (anchor.current && isOpen(pop.current)) placePop(anchor.current, pop.current!);
      else lost.current();
    };
    addEventListener('scroll', follow, { capture: true, passive: true });
    addEventListener('resize', follow, { passive: true });
    return () => {
      removeEventListener('scroll', follow, true);
      removeEventListener('resize', follow);
    };
  }, [open, anchor, pop]);
}

/** 「+N」和它的浮层。
 *
 *  指针悬停或键盘聚焦就出,指针挪到浮层上读名字时不收;点一下钉住(触屏只有这一条路),
 *  再点、点别处或 Escape 收起。 */
export function MorePop({ id, rest, label, heading, hook, children }: {
  id: string;
  rest: number;
  /** 按钮给读屏的名字:「另外 N 个别名」。 */
  label: string;
  /** 浮层标题:「7 个别名」。 */
  heading: string;
  /** 按钮自己的样式钩子:`alias`/`fact`。 */
  hook: 'alias' | 'fact';
  children: ReactNode;
}) {
  const more = useRef<HTMLButtonElement>(null);
  const pop = useRef<HTMLDivElement>(null);
  const [open, setOpen] = useState(false);
  const pinned = useRef(false);
  const closing = useRef(0);

  const hide = () => {
    clearTimeout(closing.current);
    pinned.current = false;
    if (isOpen(pop.current)) pop.current!.hidePopover();
    setOpen(false);
  };
  const show = () => {
    clearTimeout(closing.current);
    if (!pop.current || !more.current || isOpen(pop.current)) return;
    pop.current.showPopover();
    placePop(more.current, pop.current);
    setOpen(true);
  };
  const later = () => {
    clearTimeout(closing.current);
    closing.current = window.setTimeout(() => {
      if (!pinned.current && !more.current?.matches(':hover,:focus-visible') && !pop.current?.matches(':hover')) hide();
    }, 150);
  };
  useFollow(open, more, pop, hide);
  // 点在按钮和浮层以外的地方就收。
  useEffect(() => {
    if (!open) return undefined;
    const outside = (event: PointerEvent) => {
      const target = event.target as Node;
      if (!more.current?.contains(target) && !pop.current?.contains(target)) hide();
    };
    addEventListener('pointerdown', outside, true);
    return () => removeEventListener('pointerdown', outside, true);
  }, [open]);
  useEffect(() => () => clearTimeout(closing.current), []);

  return (
    <>
      <button ref={more} type="button" data-hero-more={hook} aria-expanded={open} aria-controls={id}
        aria-label={label}
        onPointerEnter={(event) => { if (event.pointerType === 'mouse') show() }}
        onPointerLeave={later}
        onFocus={() => { if (more.current?.matches(':focus-visible')) show() }}
        onBlur={later}
        onClick={() => { if (pinned.current) hide(); else { show(); pinned.current = true } }}
        onKeyDown={(event) => { if (event.key === 'Escape' && isOpen(pop.current)) { event.preventDefault(); hide() } }}>
        +{rest}
      </button>
      <div ref={pop} id={id} popover="manual" role="group" aria-label={heading} data-hero-pop=""
        onPointerEnter={() => clearTimeout(closing.current)} onPointerLeave={later}>
        <p data-hero-pop-head="">{heading}</p>
        {children}
      </div>
    </>
  );
}

/** 「订阅新作」开关:一枚 RSS 图标,开关本身藏给读屏与键盘,说明浮层悬停和键盘聚焦都出。
 *
 *  Escape 只收起这一次;指针离开或焦点移走后,下一次悬停照常出现。 */
export function FeedSwitch({ following, busy, onToggle, tip }: {
  following: boolean;
  busy: boolean;
  onToggle(on: boolean): void;
  tip: string;
}) {
  const label = useRef<HTMLLabelElement>(null);
  const input = useRef<HTMLInputElement>(null);
  const pop = useRef<HTMLSpanElement>(null);
  const [open, setOpen] = useState(false);
  const dismissed = useRef(false);

  const hideTip = () => {
    if (isOpen(pop.current)) pop.current!.hidePopover();
    setOpen(false);
  };
  const showTip = () => {
    if (dismissed.current || !pop.current || !label.current || isOpen(pop.current)) return;
    pop.current.showPopover();
    placePop(label.current, pop.current);
    setOpen(true);
  };
  const restore = () => { dismissed.current = false; hideTip() };
  useFollow(open, label, pop, () => setOpen(false));
  // 说明文字换了(订上/取消),浮层开着就按新宽度重摆一次。
  useEffect(() => {
    if (label.current && isOpen(pop.current)) placePop(label.current, pop.current!);
  }, [tip]);

  return (
    <label ref={label} data-entry-feed="" onPointerEnter={showTip}
      onPointerLeave={() => { if (!input.current?.matches(':focus-visible')) restore() }}>
      <Glyph name="rss" />
      <input ref={input} type="checkbox" role="switch" aria-label="订阅新作" aria-describedby="entityFeedTip"
        data-entity-feed="" checked={following} aria-busy={busy || undefined} aria-disabled={busy || undefined}
        onChange={(event) => { if (!busy) onToggle(event.currentTarget.checked) }}
        onKeyDown={(event) => { if (event.key === 'Escape') { dismissed.current = true; hideTip() } }}
        onFocus={() => { if (input.current?.matches(':focus-visible')) showTip() }}
        onBlur={restore} />
      <span ref={pop} role="tooltip" id="entityFeedTip" popover="manual" data-entry-feed-tip="">{tip}</span>
    </label>
  );
}