import { effect, h } from '@ui-arch/frame'; import type { ProgressProps } from './types.js'; /*** 进度条:value 信号驱动 0-100 定量态,缺省 value 则退化为不确定态(无限往复);满格切 success 色并停条纹 ***/ export function progress(props: ProgressProps = {}): HTMLElement { // —— 状态集中声明 —— const value = props.value; // 可选:不传即不确定态 const fill = h('div', { class: 'ua-progress-fill' }); const track = h('div', { class: 'ua-progress-track' }, fill); const text = h('span', { class: 'ua-progress-text' }); const withText = props.showText !== false && !!value; // 不确定态没有百分比可显示 if (!value) { fill.classList.add('ua-indeterminate'); // 宽度与往复动画交给 CSS return h('div', { class: 'ua-progress', role: 'progressbar', 'aria-label': '进行中' }, track); } effect(() => { const v = clamp(value()); // 依赖收集:信号变化自动写回 fill.style.width = `${v}%`; fill.classList.toggle('ua-done', v >= 100); // 满格切语义色 text.textContent = `${Math.round(v)}%`; }); return h( 'div', { class: 'ua-progress', role: 'progressbar', 'aria-valuemin': '0', 'aria-valuemax': '100', 'aria-valuenow': () => String(Math.round(clamp(value()))), }, track, withText ? text : null, ); } /*** 进度钳制到 0-100 ***/ function clamp(v: number): number { if (Number.isNaN(v)) return 0; // 卫语句:非法值归零 return Math.min(100, Math.max(0, v)); }