iter(g350): 数据表格补 caption 可访问名
This commit is contained in:
@@ -314,13 +314,12 @@
|
||||
"n": "password",
|
||||
"t": "boolean",
|
||||
"d": "密码框:原生打点渲染,内置「显示/隐藏」切换按钮(aria-label 同步);缺省普通文本"
|
||||
},
|
||||
{
|
||||
"n": "ariaLabel",
|
||||
"t": "string",
|
||||
"d": "无可见 label 时的可访问名(如「收件人」);缺省「文本输入」"
|
||||
}
|
||||
,
|
||||
{
|
||||
"n": "ariaLabel",
|
||||
"t": "string",
|
||||
"d": "无可见 label 时的可访问名(如「收件人」);缺省「文本输入」"
|
||||
}
|
||||
],
|
||||
"example": "const name = signal(''); const el = textField({ value: name, placeholder: '输入名字…', onInput: (v) => console.log(v) })",
|
||||
"steps": [
|
||||
@@ -388,13 +387,12 @@
|
||||
"n": "size",
|
||||
"t": "'sm' | 'md' | 'lg'",
|
||||
"d": "高度档位:sm 紧凑 / md 默认 / lg 大触控目标,走 --ua-control-h-* 三档;缺省 md"
|
||||
},
|
||||
{
|
||||
"n": "ariaLabel",
|
||||
"t": "string",
|
||||
"d": "无可见 label 时的可访问名(如「数量」);缺省「数字输入」"
|
||||
}
|
||||
,
|
||||
{
|
||||
"n": "ariaLabel",
|
||||
"t": "string",
|
||||
"d": "无可见 label 时的可访问名(如「数量」);缺省「数字输入」"
|
||||
}
|
||||
],
|
||||
"example": "const qty = signal(1); const el = inputNumber({ value: qty, min: 1, max: 99, onChange: (v) => console.log(v) })",
|
||||
"steps": [
|
||||
@@ -456,13 +454,12 @@
|
||||
"n": "autosize",
|
||||
"t": "boolean | { minRows?, maxRows? }",
|
||||
"d": "自适应内容高度:true 跟随内容涨落,对象态钳最小/最大行数,超出 maxRows 内部滚动;缺省固定行数"
|
||||
},
|
||||
{
|
||||
"n": "ariaLabel",
|
||||
"t": "string",
|
||||
"d": "无可见 label 时的可访问名(如「备注」);缺省「多行文本」"
|
||||
}
|
||||
,
|
||||
{
|
||||
"n": "ariaLabel",
|
||||
"t": "string",
|
||||
"d": "无可见 label 时的可访问名(如「备注」);缺省「多行文本」"
|
||||
}
|
||||
],
|
||||
"example": "const bio = signal(''); textarea({ value: bio, rows: 4, placeholder: '一句话介绍…' })",
|
||||
"steps": [
|
||||
@@ -539,13 +536,12 @@
|
||||
"t": "(value: number) => void",
|
||||
"k": 1,
|
||||
"d": "拖动回调"
|
||||
},
|
||||
{
|
||||
"n": "ariaLabel",
|
||||
"t": "string",
|
||||
"d": "无可见 label 时的可访问名(如「音量」);缺省「数值」,区间模式自动带「下限 / 上限」"
|
||||
}
|
||||
,
|
||||
{
|
||||
"n": "ariaLabel",
|
||||
"t": "string",
|
||||
"d": "无可见 label 时的可访问名(如「音量」);缺省「数值」,区间模式自动带「下限 / 上限」"
|
||||
}
|
||||
],
|
||||
"example": "const vol = signal(40); slider({ value: vol, min: 0, max: 100, step: 5, onChange: (v) => console.log(v) })",
|
||||
"steps": [
|
||||
@@ -2050,6 +2046,11 @@
|
||||
"t": "(row: T) => unknown",
|
||||
"k": 1,
|
||||
"d": "传了才多一列展开钮:点开在该行下铺一条详情行(内容由这里给,展开态按 rowKey 记,筛选翻页不丢)"
|
||||
},
|
||||
{
|
||||
"n": "caption",
|
||||
"t": "string",
|
||||
"d": "表格可访问名:渲染成视觉隐藏的 <caption>,读屏进表时靠它说清是哪一张表(纯图形上看不见,也不占位)"
|
||||
}
|
||||
],
|
||||
"example": "dataTable({ data: users, selectable: true, columns: [{ key: 'name', header: '姓名', sortable: true }], pageSize: 5 })",
|
||||
@@ -4674,13 +4675,46 @@
|
||||
"title": "行内编辑 Editable",
|
||||
"demo": "sec-editable",
|
||||
"props": [
|
||||
{ "n": "value", "t": "Signal<string>", "r": 1, "d": "展示值,双向绑定:只有提交才写回,Esc 取消绝不落值" },
|
||||
{ "n": "placeholder", "t": "string", "df": "'点击填写'", "d": "空值时的占位文案,颜色走辅助文字档" },
|
||||
{ "n": "label", "t": "string", "df": "'编辑'", "d": "读屏用的字段名,作静止态按钮 aria-label 的前缀(如「标题:季度目标」)" },
|
||||
{ "n": "multiline", "t": "boolean", "d": "多行模式(textarea):Enter 换行,Ctrl / Cmd + Enter 才提交;缺省单行" },
|
||||
{ "n": "disabled", "t": "boolean | Signal<boolean>", "d": "禁用只读,布尔与信号双口径;点了也不进编辑态" },
|
||||
{ "n": "validate", "t": "(v: string) => string | null", "k": 1, "d": "提交校验:返回文案即拒绝提交、保持编辑态并标红(aria-invalid + role=alert),返回 null 表示通过" },
|
||||
{ "n": "onCommit", "t": "(v: string) => void", "k": 1, "d": "提交回调,值已写回信号之后触发;取消不触发" }
|
||||
{
|
||||
"n": "value",
|
||||
"t": "Signal<string>",
|
||||
"r": 1,
|
||||
"d": "展示值,双向绑定:只有提交才写回,Esc 取消绝不落值"
|
||||
},
|
||||
{
|
||||
"n": "placeholder",
|
||||
"t": "string",
|
||||
"df": "'点击填写'",
|
||||
"d": "空值时的占位文案,颜色走辅助文字档"
|
||||
},
|
||||
{
|
||||
"n": "label",
|
||||
"t": "string",
|
||||
"df": "'编辑'",
|
||||
"d": "读屏用的字段名,作静止态按钮 aria-label 的前缀(如「标题:季度目标」)"
|
||||
},
|
||||
{
|
||||
"n": "multiline",
|
||||
"t": "boolean",
|
||||
"d": "多行模式(textarea):Enter 换行,Ctrl / Cmd + Enter 才提交;缺省单行"
|
||||
},
|
||||
{
|
||||
"n": "disabled",
|
||||
"t": "boolean | Signal<boolean>",
|
||||
"d": "禁用只读,布尔与信号双口径;点了也不进编辑态"
|
||||
},
|
||||
{
|
||||
"n": "validate",
|
||||
"t": "(v: string) => string | null",
|
||||
"k": 1,
|
||||
"d": "提交校验:返回文案即拒绝提交、保持编辑态并标红(aria-invalid + role=alert),返回 null 表示通过"
|
||||
},
|
||||
{
|
||||
"n": "onCommit",
|
||||
"t": "(v: string) => void",
|
||||
"k": 1,
|
||||
"d": "提交回调,值已写回信号之后触发;取消不触发"
|
||||
}
|
||||
],
|
||||
"example": "const title = signal('季度目标'); editable({ value: title, label: '标题', validate: (v) => (v ? null : '标题不能为空'), onCommit: (v) => toast.success('已保存:' + v) })",
|
||||
"steps": [
|
||||
@@ -4694,4 +4728,4 @@
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user