Skip to content

armgit / peach

Public Imported from GitHub
0

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

12.0 KB
Raw Blame
/* 可操作的那几样共用控件:动作忙态、Geist Switch、自绘拉条、补充信息卡与拖动排序。
   由共享源码直接引用,随 `peach-app.js` 发出;已接过忙态拦截的根是模块级状态,只有一份。 */
import { esc, icon } from '../core';

import { wireAnchoredMenu } from './anchored-menu';

/**
 * Geist loading action: visually unavailable and inert without using native
 * `disabled`, so the trigger keeps keyboard focus while its request is running.
 */
export function setActionBusy(control:Element|null|undefined,busy=true):void{
  if(!control)return;
  if(busy){
    control.setAttribute('aria-busy','true');
    control.setAttribute('aria-disabled','true');
  }else{
    control.removeAttribute('aria-busy');
    control.removeAttribute('aria-disabled');
  }
}

const busyActionRoots=new WeakSet<Node>();

/** Block repeat pointer and keyboard activation for every shared busy action. */
export function wireBusyActions(root:Node=document):void{
  if(busyActionRoots.has(root))return;
  busyActionRoots.add(root);
  root.addEventListener('click',event=>{
    const control=(event.target as Element).closest?.('button[aria-busy="true"],[role="button"][aria-busy="true"]');
    if(!control||!root.contains(control))return;
    event.preventDefault();
    event.stopImmediatePropagation();
  },true);
}

/**
 * Geist Switch:2–3 个互斥视图用共享 name 的一组 radio,不用 Toggle。
 *
 * JAV 卡片版式和关注列表版式是同一个控件——只有 name、选项和当前值不同,所以模板
 * 与 `.iconswitch` 样式共用一份;调用方各自的摆放位置仍由自己的类负责。
 */
export function iconSwitchHtml(name:string,legend:string,options:readonly (readonly any[])[],current:unknown,{attr='',className='',text=false}={}):string{
  const items=options.map(([value,label,symbol])=>
    `<label title="${esc(label)}"><input type="radio" name="${esc(name)}" value="${esc(value)}" ${attr}
      ${value===current?'checked':''}><span aria-hidden="true">${text?(symbol?icon(symbol):'')+esc(label):icon(symbol)}</span><span class="sr-only">${esc(label)}</span></label>`).join('');
  return `<fieldset class="iconswitch${text?' iconswitch-text':''}${className?` ${esc(className)}`:''}"><legend class="sr-only">${esc(legend)}</legend>${items}</fieldset>`;
}

/** 把一组 iconSwitchHtml 画出来的 radio 接到 apply(value) 上。 */
export function wireIconSwitch(root:ParentNode|null|undefined,attr:string,apply:(value:string)=>void):void{
  root?.querySelectorAll<HTMLInputElement>(`[${attr}]`).forEach(input=>{
    input.onchange=()=>{if(input.checked)apply(input.value)};
  });
}

/* 自绘单值拉条。原生 `input[type=range]` 的轨道、抓手和刻度分散在三套带厂商前缀的伪
   元素里,拿不到当前值也接不上悬停才显形的刻度;换成一个 `role="slider"` 的容器之后,
   几何、状态和键盘全在一处。形状取自 feralui.dev/gradients 的 `.dial-slider`,实测记在
   `docs/reference-snapshots/feralui-studio-boardui-accent-measured.md`:30px 高、20px 轨道、
   每 10% 一根刻度、3×20px 的圆头抓手,刻度与抓手默认透明,悬停或拖动时才出现。
   颜色一律由 `--ink` 经 color-mix 得到,焦点环仍走站内的 `--tungsten`。
   当前位置写成 `--dial-at` 交给 CSS:填充宽度和抓手位置是同一个数,分两处写就会错开。 */
const DIAL_TICKS=9;
export function dialSliderHtml({value=0,min=0,max=100,step=1,label='',suffix='%',attr='',className=''}={}):string{
  const at=max>min?(value-min)/(max-min)*100:0;
  const text=`${value}${suffix}`;
  return `<div class="ui-dial${className?` ${esc(className)}`:''}" ${attr}>
    <div class="ui-dial-slider" data-dial-slider role="slider" tabindex="0" aria-label="${esc(label)}"
      aria-valuemin="${min}" aria-valuemax="${max}" aria-valuenow="${value}" aria-valuetext="${esc(text)}"
      data-dial-step="${step}" style="--dial-at:${at}%">
      <span class="ui-dial-track" aria-hidden="true"><span class="ui-dial-fill"></span></span>
      <span class="ui-dial-ticks" aria-hidden="true">${'<span></span>'.repeat(DIAL_TICKS)}</span>
      <span class="ui-dial-handle" aria-hidden="true"></span>
    </div><b class="ui-dial-value mono" data-dial-value>${esc(text)}</b></div>`;
}

/**
 * 接上 dialSliderHtml 画出来的一条拉条。
 *
 * `onInput` 在拖动和键盘的每一步都发,调用方自己合并到一帧里;`onChange` 只在松手、
 * 键盘落键和触摸取消时发一次,落盘归它。两者分开是这条拉条唯一的性能约定:拖动中
 * 每一步都写 localStorage 的话,一次 60 步的拖动就是 60 次同步序列化。
 */
export function wireDialSlider(root:ParentNode,{onInput=()=>{},onChange=()=>{},suffix='%'}:{
  onInput?: (value:number)=>void; onChange?: (value:number)=>void; suffix?: string;
}={}):{readonly value:number;set(next:number):void}{
  const slider:any=root.querySelector('[data-dial-slider]'),readout=root.querySelector('[data-dial-value]');
  const track:any=root.querySelector('.ui-dial-track');
  const min=+slider.getAttribute('aria-valuemin'),max=+slider.getAttribute('aria-valuemax');
  const step=+slider.dataset.dialStep||1;
  let value=+slider.getAttribute('aria-valuenow');
  const clamp=(raw:number)=>Math.min(max,Math.max(min,Math.round(raw/step)*step));
  const paint=()=>{
    const text=`${value}${suffix}`;
    slider.style.setProperty('--dial-at',`${max>min?(value-min)/(max-min)*100:0}%`);
    slider.setAttribute('aria-valuenow',String(value));
    slider.setAttribute('aria-valuetext',text);
    if(readout)readout.textContent=text;
  };
  const set=(raw:number,notify:boolean)=>{
    const next=clamp(raw);
    if(next===value)return false;
    value=next;paint();if(notify)onInput(value);return true;
  };
  /* 轨道几何在按下那一刻量一次就够,之后每次 pointermove 都读缓存。指针捕获期间这条
     轨道不会跑,而 `getBoundingClientRect()` 会强制同步一次样式与布局——放在每一个
     pointermove 里,一次拖动就是上百次强制布局,实测占掉这条链路一大半时间。 */
  let trackBox:DOMRect|null=null;
  const fromPointer=(event:PointerEvent)=>{
    const rect=trackBox||track.getBoundingClientRect();
    const ratio=rect.width?(event.clientX-rect.left)/rect.width:0;
    set(min+(max-min)*Math.min(1,Math.max(0,ratio)),true);
  };
  slider.addEventListener('pointerdown',(event:PointerEvent)=>{
    if(event.pointerType==='mouse'&&event.button!==0)return;
    event.preventDefault();slider.focus();
    trackBox=track.getBoundingClientRect();
    slider.dataset.dragging='true';
    /* 指针捕获拿不到就算了:一次合成出来的 pointerdown(自动化、辅助技术)带的 id
       不对应任何活动指针,`setPointerCapture` 会抛,抛出去整条拖动就断在第一步。 */
    try{slider.setPointerCapture(event.pointerId)}catch{}
    fromPointer(event);
  });
  slider.addEventListener('pointermove',(event:PointerEvent)=>{if(slider.dataset.dragging==='true')fromPointer(event)});
  const release=(event:PointerEvent)=>{
    if(slider.dataset.dragging!=='true')return;
    delete slider.dataset.dragging;trackBox=null;
    try{if(slider.hasPointerCapture(event.pointerId))slider.releasePointerCapture(event.pointerId)}catch{}
    onChange(value);
  };
  slider.addEventListener('pointerup',release);
  slider.addEventListener('pointercancel',release);
  /* 键盘一档就是一个 step,按住 Shift 走 10。Home/End 直接到两端:一条 0–100 的拉条
     用方向键从一头走到另一头要按一百下,那不叫可用。 */
  slider.addEventListener('keydown',(event:KeyboardEvent)=>{
    const span=event.shiftKey?10:step;
    const moves:Record<string,number>={ArrowLeft:-span,ArrowDown:-span,ArrowRight:span,ArrowUp:span};
    let next:number|null=null;
    if(event.key in moves)next=value+moves[event.key]!;
    else if(event.key==='Home')next=min;
    else if(event.key==='End')next=max;
    if(next===null)return;
    event.preventDefault();
    if(set(next,true))onChange(value);
  });
  return {get value(){return value},set(next:number){set(next,false)}};
}

/** 复杂补充信息复用顶层浮层和视口避让,正文可聚焦并独立滚动。
 *  `panel` 进顶层、锚在 `trigger` 旁,悬停 150ms 或点一下打开,`mount` 里按 Escape 收起。 */
export function wireContextCard(mount:HTMLElement,trigger:HTMLElement,panel:HTMLElement):{
  setOpen(open:boolean):void; isOpen():boolean; hide():void;
}{
  panel.classList.add('context-card');panel.setAttribute('popover','manual');
  panel.setAttribute('role','dialog');panel.tabIndex=-1;
  trigger.setAttribute('aria-haspopup','dialog');trigger.setAttribute('aria-controls',panel.id);
  const floating=wireAnchoredMenu(mount,trigger,panel);
  let timer:ReturnType<typeof setTimeout>|undefined;
  const hide=()=>{clearTimeout(timer);floating.setOpen(false)};
  const enter=()=>{clearTimeout(timer);timer=setTimeout(()=>{if(trigger.isConnected)floating.setOpen(true)},150)};
  const leave=()=>{clearTimeout(timer);timer=setTimeout(()=>{if(!panel.matches(':hover')&&!trigger.matches(':hover')&&!panel.contains(document.activeElement)&&document.activeElement!==trigger)hide()},150)};
  trigger.addEventListener('pointerenter',enter);trigger.addEventListener('pointerleave',leave);
  panel.addEventListener('pointerenter',()=>clearTimeout(timer));panel.addEventListener('pointerleave',leave);
  trigger.addEventListener('focus',enter);trigger.addEventListener('blur',leave);
  trigger.addEventListener('click',()=>clearTimeout(timer));
  mount.addEventListener('keydown',event=>{if(event.key==='Escape')hide()});
  panel.addEventListener('focusout',leave);
  trigger.addEventListener('keydown',event=>{if(event.key==='ArrowDown'&&floating.isOpen()){event.preventDefault();(panel.querySelector<HTMLElement>('a,button,[tabindex="0"]')||panel).focus()}});
  return {...floating,hide};
}

/* 拖动排序:一列带 key 的行,拖到哪一行的上半截或下半截就插到那里。

   站内此前有两份几乎一样的实现(侧栏顺序、导航按钮),第三处再抄一遍,落点判据、
   拖动中的减淡和那条插入线就会各演化一份。这里只收「一列行」这一种:拖动中的行加
   `dragging`,落点行加 `drop-before` / `drop-after`,样式由调用方那一侧的类名给。

   `onMove(key,target,after)` 拿到的是两个 key 和一个方位,重排由调用方自己做——
   顺序存在哪、存完刷什么,各处本来就不一样。 */
export function wireDragReorder(root:ParentNode,{selector,attribute,onMove}:{
  selector?: any; attribute?: any; onMove?: any;
}={}):void{
  const rows=():HTMLElement[]=>[...root.querySelectorAll<HTMLElement>(selector)];
  const clear=()=>rows().forEach(row=>row.classList.remove('dragging','drop-before','drop-after'));
  let dragging:string|null=null;
  rows().forEach(row=>{
    const key=row.getAttribute(attribute);
    row.draggable=true;
    row.addEventListener('dragstart',event=>{
      dragging=key;row.classList.add('dragging');
      event.dataTransfer!.effectAllowed='move';
      // 不写 dataTransfer 的话 Firefox 根本不认这是一次拖动;首页那一项的 key 是空串,
      // 空串等于没写,所以给它一个占位。落点判据只看 key 本身,不看这里写的字。
      event.dataTransfer!.setData('text/plain',key||'peach-row');
    });
    row.addEventListener('dragover',event=>{
      if(dragging===null||dragging===key)return;
      event.preventDefault();event.dataTransfer!.dropEffect='move';
      const after=event.clientY>row.getBoundingClientRect().top+row.offsetHeight/2;
      rows().forEach(item=>item.classList.remove('drop-before','drop-after'));
      row.classList.add(after?'drop-after':'drop-before');
    });
    row.addEventListener('drop',event=>{
      event.preventDefault();
      const after=row.classList.contains('drop-after'),from=dragging;
      dragging=null;clear();
      if(from!==null&&from!==key)onMove(from,key,after);
    });
    row.addEventListener('dragend',()=>{dragging=null;clear()});
  });
}