From 151d901bb9e77c6bf707d21a53a140551536ed4a Mon Sep 17 00:00:00 2001 From: HIsheR Date: Mon, 26 Oct 2026 14:31:15 +0800 Subject: [PATCH] =?UTF-8?q?iter(g121):=20textField=20=E8=A1=A5=20maxCount?= =?UTF-8?q?=20=E5=AD=97=E6=95=B0=E7=BB=9F=E8=AE=A1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .ua/backlog.json | 8 ++++++++ llms-full.txt | 6 ++++-- packages/skin/ui/src/textField.ts | 14 ++++++++++++-- packages/skin/ui/src/types.ts | 1 + packages/skin/ui/ua.manifest.json | 10 ++++++++-- packages/skin/ui/ui.css | 7 ++++++- 6 files changed, 39 insertions(+), 7 deletions(-) diff --git a/.ua/backlog.json b/.ua/backlog.json index 2016e17..9ae34c2 100644 --- a/.ua/backlog.json +++ b/.ua/backlog.json @@ -1324,6 +1324,14 @@ "acceptance": "AGENTS.md「贡献新组件」章节补一张 10 行的落点表（每个落点写清具体动作与门禁原因），并说明改既有组件入参同样要走 manifest / docs 三步；npm run check 全绿", "notes": "自补：Agent 文档完善；把本轮踩到的同步点固化成清单", "status": "done" + }, + { + "id": "g121", + "title": "textField 补 maxCount 字数统计", + "motivation": "textarea 早有 maxCount（原生上限 + 实时 n/limit），textField 却没有：昵称、标题、单行备注这类短字段同样需要限长，调用方只能自己拼计数节点贴在输入框外，样式与位置各写各的", + "acceptance": "TextFieldProps 新增 maxCount（缺省不渲染）：传了即设原生 maxlength 拦截超限输入，输入框内侧附加组显示实时 n/上限（数字等宽不抖）；与 clearable 共存时同组并排；文档参数表 / api 说明 / 手把手与 llms-full.txt 同步；npm run check 全绿", + "notes": "自补：输入类一致性；计数与清空共用后置附加组，零新增布局容器", + "status": "open" } ] } diff --git a/llms-full.txt b/llms-full.txt index e0bfb32..3166d3e 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -1,6 +1,6 @@ # @ui-arch 组件库 Agent 文档（无图形版） -> 自动生成于 2026-10-26T06:12:21.011Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。 +> 自动生成于 2026-10-26T06:30:27.757Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。 ## 快速上手 @@ -111,6 +111,7 @@ button({ label: '提交', variant: 'primary', onClick: () => console.log('clicke - prefix：string | HTMLElement —— 前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染 - suffix：string | HTMLElement —— 后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染 - clearable（默认 false）：boolean —— 开启后有值即显示一键清空按钮；缺省 false +- maxCount：number —— 字数上限：同时设原生 maxlength，并在输入框内侧显示实时计数；缺省不限 示例： @@ -124,6 +125,7 @@ const name = signal(''); const el = textField({ value: name, placeholder: '输 2. 传入 value 完成双向绑定：用户输入自动写回，外部赋值自动回显 3. 在任意响应式位置用 name() 读取最新值，如 () => `你好，${name()}` 4. 需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载 +5. 需要限制长度就给 maxCount：超限输入被原生拦截，输入框内侧实时显示 n/上限 现场演示：apps/docs/demo.html#sec-bind @@ -1661,7 +1663,7 @@ const day = signal(''); calendar({ value: day, marker: (d) => (d === '2026-10-26 API 速览： - button(props)：按钮，variant = primary | ghost | danger，disabled 支持布尔或信号禁用；type 缺省 button（表单内不隐式提交） -- textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号，onInput 输入回调；prefix/suffix 可选渲染为输入框内侧附加块，clearable 开启后有值即显一键清空按钮 +- textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号，onInput 输入回调；prefix/suffix 可选渲染为输入框内侧附加块，clearable 开启后有值即显一键清空按钮，maxCount 设原生上限并实时显示字数 - inputNumber(props)：数字输入，−/+ 按钮与键盘 ↑↓ 调节（长按连发步进），min/max/step 夹取；prefix/suffix 可选渲染为整组前后附加块 - textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号，rows 控行数；prefix/suffix 可选渲染为上下附加块，maxCount 显示实时字数并设原生上限 - slider(props)：滑块，value 信号双向绑定，min/max/step 可配，原生 range 承载键盘交互，右侧可显示当前值 diff --git a/packages/skin/ui/src/textField.ts b/packages/skin/ui/src/textField.ts index db1b598..f3d209d 100644 --- a/packages/skin/ui/src/textField.ts +++ b/packages/skin/ui/src/textField.ts @@ -2,7 +2,7 @@ import { effect, h } from '@ui-arch/frame'; import { addonWrap } from './addons.js'; import type { TextFieldProps } from './types.js'; -/*** 文本输入：value 信号双向绑定，disabled 支持布尔或信号禁用，onInput 为输入回调；prefix/suffix 包附加组，clearable 一键清空 ***/ +/*** 文本输入：value 信号双向绑定，disabled 支持布尔或信号禁用，onInput 为输入回调；prefix/suffix 包附加组，clearable 一键清空，maxCount 显示字数统计 ***/ export function textField(props: TextFieldProps): HTMLElement { const el = h('input', { class: 'ua-input', placeholder: props.placeholder ?? '', disabled: props.disabled }) as HTMLInputElement; // false/undefined 移除属性，Signal 走响应式 if (props.value) { @@ -30,6 +30,16 @@ export function textField(props: TextFieldProps): HTMLElement { el.addEventListener('input', syncClear); // 用户输入时同步 effect(() => { if (props.value) props.value(); syncClear(); }); // 外部写回时同步（读信号建依赖） } - const suffix = clearBtn ? h('span', { class: 'ua-input-clear-group' }, clearBtn, props.suffix ?? null) : props.suffix; // 清空按钮并入后置附加组 + let counter: HTMLElement | null = null; // 字数统计块；maxCount 未传不创建 + if (props.maxCount) { + el.setAttribute('maxlength', String(props.maxCount)); // 原生拦截超限输入 + counter = h('span', { class: 'ua-input-count' }); + const syncCount = (): void => { counter!.textContent = `${el.value.length}/${props.maxCount}`; }; // 实时 n/limit + el.addEventListener('input', syncCount); // 用户输入时同步 + effect(() => { if (props.value) props.value(); syncCount(); }); // 初始与外部写回时同步（读信号建依赖） + } + const suffix = clearBtn || counter + ? h('span', { class: 'ua-input-clear-group' }, clearBtn, counter, props.suffix ?? null) // 清空按钮 / 计数并入后置附加组 + : props.suffix; return addonWrap(el, props.prefix, suffix); } diff --git a/packages/skin/ui/src/types.ts b/packages/skin/ui/src/types.ts index 8332c68..f57dfca 100644 --- a/packages/skin/ui/src/types.ts +++ b/packages/skin/ui/src/types.ts @@ -37,6 +37,7 @@ export interface TextFieldProps { prefix?: string | HTMLElement; // 输入框内侧前置附加块（如图标、货币符）；缺省不渲染 suffix?: string | HTMLElement; // 输入框内侧后置附加块（如单位）；缺省不渲染 clearable?: boolean; // 开启后有值时显示一键清空按钮；缺省不渲染 + maxCount?: number; // 字数上限；传了即设原生 maxlength 并在输入框内侧显示实时计数 } /*** 卡片入参 ***/ diff --git a/packages/skin/ui/ua.manifest.json b/packages/skin/ui/ua.manifest.json index 7c4f7fa..10c0b60 100644 --- a/packages/skin/ui/ua.manifest.json +++ b/packages/skin/ui/ua.manifest.json @@ -14,7 +14,7 @@ "entry": "src/index.ts", "exports": [ "button(props)：按钮，variant = primary | ghost | danger，disabled 支持布尔或信号禁用；type 缺省 button（表单内不隐式提交）", - "textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号，onInput 输入回调；prefix/suffix 可选渲染为输入框内侧附加块，clearable 开启后有值即显一键清空按钮", + "textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号，onInput 输入回调；prefix/suffix 可选渲染为输入框内侧附加块，clearable 开启后有值即显一键清空按钮，maxCount 设原生上限并实时显示字数", "inputNumber(props)：数字输入，−/+ 按钮与键盘 ↑↓ 调节（长按连发步进），min/max/step 夹取；prefix/suffix 可选渲染为整组前后附加块", "textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号，rows 控行数；prefix/suffix 可选渲染为上下附加块，maxCount 显示实时字数并设原生上限", "slider(props)：滑块，value 信号双向绑定，min/max/step 可配，原生 range 承载键盘交互，右侧可显示当前值", @@ -257,6 +257,11 @@ "t": "boolean", "df": "false", "d": "开启后有值即显示一键清空按钮；缺省 false" + }, + { + "n": "maxCount", + "t": "number", + "d": "字数上限：同时设原生 maxlength，并在输入框内侧显示实时计数；缺省不限" } ], "example": "const name = signal(''); const el = textField({ value: name, placeholder: '输入名字…', onInput: (v) => console.log(v) })", @@ -264,7 +269,8 @@ "先用 signal('') 创建字符串信号", "传入 value 完成双向绑定：用户输入自动写回，外部赋值自动回显", "在任意响应式位置用 name() 读取最新值，如 () => `你好，${name()}`", - "需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载" + "需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载", + "需要限制长度就给 maxCount：超限输入被原生拦截，输入框内侧实时显示 n/上限" ] }, { diff --git a/packages/skin/ui/ui.css b/packages/skin/ui/ui.css index 7a60d33..922f880 100644 --- a/packages/skin/ui/ui.css +++ b/packages/skin/ui/ui.css @@ -1955,10 +1955,15 @@ button.ua-step-dot:hover { user-select: none; } .ua-input-clear-group { - display: inline-flex; /* 清空按钮 + 原有 suffix 并排 */ + display: inline-flex; /* 清空按钮 / 计数 + 原有 suffix 并排 */ align-items: center; gap: 4px; } +.ua-input-count { + color: var(--ua-color-text-muted); + font-size: var(--ua-font-size-sm); + font-variant-numeric: tabular-nums; /* 数字等宽，跳动不抖 */ +} .ua-input-clear { border: none; /* 一键清空：小圆钮，弱化视觉 */ background: none;