diff --git a/.ua/backlog.json b/.ua/backlog.json index 3ee7c0d..d96b262 100644 --- a/.ua/backlog.json +++ b/.ua/backlog.json @@ -1309,6 +1309,14 @@ "notes": "自补:发版前刷新步骤;本次唤起收尾轮", "status": "done" }, + { + "id": "g124", + "title": "checkbox 补 indeterminate 半选态", + "motivation": "全选/子项联动只能表达「全勾」与「全不勾」:部分选中时全选框没有任何视觉区分,dataTable 内部的全选三态也是包私有实现,独立 checkbox 场景(树形勾选、批量列选择)用不上", + "acceptance": "CheckboxProps 新增 indeterminate(布尔或信号):同步到原生 input.indeterminate 属性,accent-color 自动渲染横杠,读屏播报 mixed;不改变 checked 值与点击语义(点一下即回全选);文档参数表 / api 说明 / 手把手与 llms-full.txt 同步;npm run check 全绿", + "notes": "自补:组件能力补齐;零新增 CSS(accent-color 原生覆盖 :indeterminate)", + "status": "open" + }, { "id": "g119", "title": "空状态支持自定义图标", diff --git a/.ua/index.json b/.ua/index.json index acf0ffb..baedabc 100644 --- a/.ua/index.json +++ b/.ua/index.json @@ -1,6 +1,6 @@ { "$schema": "ui-arch-registry-index/0.1", - "generatedAt": "2026-10-26T06:33:37.851Z", + "generatedAt": "2026-10-26T06:36:53.099Z", "repoRoot": ".", "packages": [ { @@ -147,7 +147,7 @@ "inputNumber(props):数字输入,−/+ 按钮与键盘 ↑↓ 调节(长按连发步进),min/max/step 夹取;prefix/suffix 可选渲染为整组前后附加块", "textarea(props):多行输入,value 信号双向绑定,disabled 支持布尔或信号,rows 控行数;prefix/suffix 可选渲染为上下附加块,maxCount 显示实时字数并设原生上限", "slider(props):滑块,value 信号双向绑定,min/max/step 可配,原生 range 承载键盘交互,右侧可显示当前值", - "checkbox(props):复选框,checked 信号双向绑定,disabled 支持布尔或信号禁用", + "checkbox(props):复选框,checked 信号双向绑定,indeterminate 半选态(读屏播报 mixed),disabled 支持布尔或信号禁用", "switchButton(props):开关,checked 信号双向绑定,disabled 支持布尔或信号禁用", "select(props):自绘下拉选择(非原生 select),value 信号双向绑定,点外部 / Esc 关闭,选项弹层带微动画,disabled 支持布尔或信号禁用,空间不足自动翻转,键入字母快跳选项;searchable 开启弹层搜索框,clearable 有值时给清空按钮", "menu(props):下拉菜单,触发器 + 自绘弹层,条目支持禁用 / 危险 / 分隔线,↑↓ 环形导航,点外部 / Esc 关闭,空间不足自动翻转,键入字母快跳菜单项", @@ -586,6 +586,11 @@ "t": "string", "d": "右侧文案;缺省只渲染勾选框" }, + { + "n": "indeterminate", + "t": "boolean | Signal", + "d": "半选态(批量选择时部分子项选中):仅影响视觉与读屏 mixed 播报,不改变 checked 值;点一下即回到全选" + }, { "n": "disabled", "t": "boolean | Signal", @@ -602,7 +607,8 @@ "steps": [ "创建布尔信号 agreed = signal(false)", "传入 checked 与 label,勾选即写回信号", - "表单提交前用 agreed() 判断是否勾选" + "表单提交前用 agreed() 判断是否勾选", + "做全选/子项联动时把「部分选中」折算成 indeterminate(布尔或信号):视觉显示横杠,读屏播报 mixed,点一下即全选" ] }, { diff --git a/llms-full.txt b/llms-full.txt index ec3ea7f..e91ebb2 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -1,6 +1,6 @@ # @ui-arch 组件库 Agent 文档(无图形版) -> 自动生成于 2026-10-26T06:33:37.851Z,数据源:各包 ua.manifest.json,勿手改。人类版文档站:apps/docs/index.html。 +> 自动生成于 2026-10-26T06:36:53.099Z,数据源:各包 ua.manifest.json,勿手改。人类版文档站:apps/docs/index.html。 > 组件 = 普通函数,传 props 返回 DOM;状态用 signal 双向绑定:读 signal() 写 signal(v)。 ## 快速上手 @@ -219,6 +219,7 @@ const vol = signal(40); slider({ value: vol, min: 0, max: 100, step: 5, onChange - checked:Signal —— 勾选状态信号,双向绑定 - label:string —— 右侧文案;缺省只渲染勾选框 +- indeterminate:boolean | Signal —— 半选态(批量选择时部分子项选中):仅影响视觉与读屏 mixed 播报,不改变 checked 值;点一下即回到全选 - disabled:boolean | Signal —— 禁用态:布尔直接置位,传信号则动态同步 - onChange(回调):(checked: boolean) => void —— 变更回调 @@ -233,6 +234,7 @@ const agreed = signal(false); checkbox({ label: '同意条款', checked: agreed, 1. 创建布尔信号 agreed = signal(false) 2. 传入 checked 与 label,勾选即写回信号 3. 表单提交前用 agreed() 判断是否勾选 +4. 做全选/子项联动时把「部分选中」折算成 indeterminate(布尔或信号):视觉显示横杠,读屏播报 mixed,点一下即全选 现场演示:apps/docs/demo.html#sec-form @@ -1669,7 +1671,7 @@ API 速览: - inputNumber(props):数字输入,−/+ 按钮与键盘 ↑↓ 调节(长按连发步进),min/max/step 夹取;prefix/suffix 可选渲染为整组前后附加块 - textarea(props):多行输入,value 信号双向绑定,disabled 支持布尔或信号,rows 控行数;prefix/suffix 可选渲染为上下附加块,maxCount 显示实时字数并设原生上限 - slider(props):滑块,value 信号双向绑定,min/max/step 可配,原生 range 承载键盘交互,右侧可显示当前值 -- checkbox(props):复选框,checked 信号双向绑定,disabled 支持布尔或信号禁用 +- checkbox(props):复选框,checked 信号双向绑定,indeterminate 半选态(读屏播报 mixed),disabled 支持布尔或信号禁用 - switchButton(props):开关,checked 信号双向绑定,disabled 支持布尔或信号禁用 - select(props):自绘下拉选择(非原生 select),value 信号双向绑定,点外部 / Esc 关闭,选项弹层带微动画,disabled 支持布尔或信号禁用,空间不足自动翻转,键入字母快跳选项;searchable 开启弹层搜索框,clearable 有值时给清空按钮 - menu(props):下拉菜单,触发器 + 自绘弹层,条目支持禁用 / 危险 / 分隔线,↑↓ 环形导航,点外部 / Esc 关闭,空间不足自动翻转,键入字母快跳菜单项 diff --git a/llms.txt b/llms.txt index 0ed09ae..92c33f9 100644 --- a/llms.txt +++ b/llms.txt @@ -52,7 +52,7 @@ - inputNumber(props):数字输入,−/+ 按钮与键盘 ↑↓ 调节(长按连发步进),min/max/step 夹取;prefix/suffix 可选渲染为整组前后附加块 - textarea(props):多行输入,value 信号双向绑定,disabled 支持布尔或信号,rows 控行数;prefix/suffix 可选渲染为上下附加块,maxCount 显示实时字数并设原生上限 - slider(props):滑块,value 信号双向绑定,min/max/step 可配,原生 range 承载键盘交互,右侧可显示当前值 - - checkbox(props):复选框,checked 信号双向绑定,disabled 支持布尔或信号禁用 + - checkbox(props):复选框,checked 信号双向绑定,indeterminate 半选态(读屏播报 mixed),disabled 支持布尔或信号禁用 - switchButton(props):开关,checked 信号双向绑定,disabled 支持布尔或信号禁用 - select(props):自绘下拉选择(非原生 select),value 信号双向绑定,点外部 / Esc 关闭,选项弹层带微动画,disabled 支持布尔或信号禁用,空间不足自动翻转,键入字母快跳选项;searchable 开启弹层搜索框,clearable 有值时给清空按钮 - menu(props):下拉菜单,触发器 + 自绘弹层,条目支持禁用 / 危险 / 分隔线,↑↓ 环形导航,点外部 / Esc 关闭,空间不足自动翻转,键入字母快跳菜单项 diff --git a/packages/skin/ui/src/checkbox.ts b/packages/skin/ui/src/checkbox.ts index bd60420..289816e 100644 --- a/packages/skin/ui/src/checkbox.ts +++ b/packages/skin/ui/src/checkbox.ts @@ -1,7 +1,7 @@ import { effect, h } from '@ui-arch/frame'; import type { CheckboxProps } from './types.js'; -/*** 复选框:checked 信号双向绑定,disabled 支持布尔或信号禁用,onChange 为变更回调 ***/ +/*** 复选框:checked 信号双向绑定,indeterminate 半选态(视觉与 mixed 播报),disabled 支持布尔或信号禁用,onChange 为变更回调 ***/ export function checkbox(props: CheckboxProps): HTMLElement { const el = h('input', { type: 'checkbox', class: 'ua-checkbox', disabled: props.disabled }) as HTMLInputElement; // false/undefined 移除属性,Signal 走响应式 if (props.checked) { @@ -11,6 +11,10 @@ export function checkbox(props: CheckboxProps): HTMLElement { if (el.checked !== checked()) el.checked = checked(); // 外部变化写回勾选框 }); } + if (props.indeterminate !== undefined) { + const ind = props.indeterminate; + effect(() => { el.indeterminate = typeof ind === 'function' ? ind() : !!ind; }); // 半选态同步原生属性(accent-color 自动渲染横杠,读屏播报 mixed) + } if (props.onChange) el.addEventListener('change', () => props.onChange!(el.checked)); if (!props.label) return el; const wrap = h('label', { class: 'ua-check-row' }, el, props.label); diff --git a/packages/skin/ui/src/types.ts b/packages/skin/ui/src/types.ts index 7030611..c3eb36b 100644 --- a/packages/skin/ui/src/types.ts +++ b/packages/skin/ui/src/types.ts @@ -89,6 +89,7 @@ export interface SegmentedProps { export interface CheckboxProps { label?: string; // 右侧文案;缺省不渲染 checked?: Signal; // 勾选状态信号,双向绑定 + indeterminate?: boolean | Signal; // 半选态(批量选择时部分子项选中):仅影响视觉与读屏 mixed 播报,不改变 checked 值 disabled?: boolean | Signal; // 禁用态:布尔直接置位,传信号则动态同步 onChange?: (checked: boolean) => void; // 变更回调 } diff --git a/packages/skin/ui/ua.manifest.json b/packages/skin/ui/ua.manifest.json index a920ffb..772abe0 100644 --- a/packages/skin/ui/ua.manifest.json +++ b/packages/skin/ui/ua.manifest.json @@ -18,7 +18,7 @@ "inputNumber(props):数字输入,−/+ 按钮与键盘 ↑↓ 调节(长按连发步进),min/max/step 夹取;prefix/suffix 可选渲染为整组前后附加块", "textarea(props):多行输入,value 信号双向绑定,disabled 支持布尔或信号,rows 控行数;prefix/suffix 可选渲染为上下附加块,maxCount 显示实时字数并设原生上限", "slider(props):滑块,value 信号双向绑定,min/max/step 可配,原生 range 承载键盘交互,右侧可显示当前值", - "checkbox(props):复选框,checked 信号双向绑定,disabled 支持布尔或信号禁用", + "checkbox(props):复选框,checked 信号双向绑定,indeterminate 半选态(读屏播报 mixed),disabled 支持布尔或信号禁用", "switchButton(props):开关,checked 信号双向绑定,disabled 支持布尔或信号禁用", "select(props):自绘下拉选择(非原生 select),value 信号双向绑定,点外部 / Esc 关闭,选项弹层带微动画,disabled 支持布尔或信号禁用,空间不足自动翻转,键入字母快跳选项;searchable 开启弹层搜索框,clearable 有值时给清空按钮", "menu(props):下拉菜单,触发器 + 自绘弹层,条目支持禁用 / 危险 / 分隔线,↑↓ 环形导航,点外部 / Esc 关闭,空间不足自动翻转,键入字母快跳菜单项", @@ -457,6 +457,11 @@ "t": "string", "d": "右侧文案;缺省只渲染勾选框" }, + { + "n": "indeterminate", + "t": "boolean | Signal", + "d": "半选态(批量选择时部分子项选中):仅影响视觉与读屏 mixed 播报,不改变 checked 值;点一下即回到全选" + }, { "n": "disabled", "t": "boolean | Signal", @@ -473,7 +478,8 @@ "steps": [ "创建布尔信号 agreed = signal(false)", "传入 checked 与 label,勾选即写回信号", - "表单提交前用 agreed() 判断是否勾选" + "表单提交前用 agreed() 判断是否勾选", + "做全选/子项联动时把「部分选中」折算成 indeterminate(布尔或信号):视觉显示横杠,读屏播报 mixed,点一下即全选" ] }, {