Files
UI/packages/skin/ui/src/switch.ts
T
2026-10-26 14:44:37 +08:00

37 lines
2.0 KiB
TypeScript

import { effect, h } from '@ui-arch/frame';
import type { SwitchProps } from './types.js';
/*** 开关:checked 信号双向绑定,loading 加载锁(转圈 + 禁点),disabled 支持布尔或信号禁用,轨道 + 滑块的纯 CSS 实现 ***/
export function switchButton(props: SwitchProps): HTMLElement {
const hasLoading = props.loading !== undefined; // 加载态接管禁用写入时,disabled 不再走 h() 双写
const input = h('input', {
type: 'checkbox',
class: 'ua-switch-input',
role: 'switch', // 用开关语义而非复选框:读屏播报「开关」并跟随选中态
'aria-label': props.ariaLabel ?? props.label, // 无可见文案时也要有可访问名
disabled: hasLoading ? undefined : props.disabled, // false/undefined 移除属性,Signal 走响应式
}) as HTMLInputElement;
if (props.checked) {
const checked = props.checked;
input.addEventListener('change', () => checked(input.checked)); // 用户切换写回信号
effect(() => {
if (input.checked !== checked()) input.checked = checked(); // 外部变化写回开关
});
}
if (props.onChange) input.addEventListener('change', () => props.onChange!(input.checked));
const track = h('span', { class: 'ua-switch-track' }, h('span', { class: 'ua-switch-thumb' }));
const el = h('label', { class: 'ua-switch' }, input, track);
if (hasLoading) {
const ld = props.loading; // 加载态:单一写入口同时管 disabled 与转圈,避免与 disabled 信号双写竞争
const dis = props.disabled;
effect(() => {
const busy = typeof ld === 'function' ? ld() : !!ld;
input.disabled = busy || (typeof dis === 'function' ? dis() : !!dis); // 加载中锁定交互
el.classList.toggle('is-loading', busy); // 滑块转圈由 CSS 承载
input.setAttribute('aria-busy', String(busy)); // 读屏可感知忙碌
});
}
if (props.label) el.append(h('span', { class: 'ua-switch-label' }, props.label));
return el;
}