iter(g121): textField 补 maxCount 字数统计

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);
 }

packages/skin/ui/src/types.ts

@@ -37,6 +37,7 @@ export interface TextFieldProps {
   prefix?: string | HTMLElement;     // 输入框内侧前置附加块（如图标、货币符）；缺省不渲染
   suffix?: string | HTMLElement;     // 输入框内侧后置附加块（如单位）；缺省不渲染
   clearable?: boolean;               // 开启后有值时显示一键清空按钮；缺省不渲染
+  maxCount?: number;                 // 字数上限；传了即设原生 maxlength 并在输入框内侧显示实时计数
 }
 
 /*** 卡片入参 ***/

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/上限"
         ]
       },
       {

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;