一个广告回报计算器在电脑上看似已经做好,可是访客不用鼠标就无法更改币种。Vercel Labs 的 UI SDK 针对的正是这种落差。这款仍处于测试阶段的库给编程智能体提供可复用的交互行为,不规定界面的视觉样式。项目仓库列出核心能力,包括键盘导航、焦点管理、选择、关闭、弹出层、拖放及相关 ARIA 语义。官方文档演示了如何组合这些行为。工具改变了团队可以让智能体生成什么,但没有改变谁应当验证访客最终拿到的网页。

交互行为层有哪些变化?

带有样式的组件通常把外观、布局和交互绑在一起。例如,弹出层可能自带某种边框和阴影,也规定怎样使用键盘。交互行为的基础模块则负责后一部分,比如什么动作触发弹出层、它应与按钮怎样定位、又如何关闭。独立的选择行为可以区分用户正在浏览的选项和已确认的选项。字体、间距、品牌配色及清楚的标签仍由网站决定。对于营销页,团队不必为了一个操作可靠的选择器而改变自己的设计语言。

UI SDK 的示例把弹出层、选择与键入查找组合成一个控件。键入查找让访客通过输入来定位选项,不用遍历整个列表。不同外观的控件可能有同样的交互需求,这就是复用的价值,但不能把相同规则套在所有页面上。一个不阻止用户继续浏览页面的选择器,与一个在执行不可撤销操作前阻止其他交互的对话框,可能需要不同的焦点与关闭规则。告诉智能体实际任务和合适的控件模式,比让所有东西都像菜单一样工作更清楚。

什么时候适合试用测试版?

仓库标明了 Apache-2.0 许可证及测试版状态,还列出围绕同一个核心的五种适配方案:React、Vue、Svelte、Solid 和 Web Components。这个列表不能证明每个现有项目、构建流程或组件系统都能原样接入。用最贴合现有原型的框架来测试,不必为了验证一个交互而重写整个应用。官方示例能帮助理解设计思路,但不能代替对团队自己实现的控件进行验收。

可以在一次性试验原型中使用合成数据,明确由哪位工程人员负责审核。记录所用框架和被评估的版本、当前控件的优势,以及哪些改造会增加撤回成本。如果原生控件已经够用,或测试版增加的维护量高于节省的工作,就保留原实施路径。项目提供面向编程智能体的使用说明,并不意味着应该自动安装依赖或批准生产变更。实际问题在于:一个原本困难的交互,是否变得更好交付,也更易于长期维护?

分层图将自定义界面、焦点与 ARIA 和键盘行为,以及框架适配器区分开,并提示测试最终界面。

为卡里姆·埃尔加奈尼网站制作的原创示意图,参考 UI SDK 项目文档。图中的分层用于解释概念,不是官方架构图,也不代表无障碍认证。

从一个非医疗营销工具开始

假设文具零售商要为活动做一张广告支出回报的动态测算表。访客用同一种货币填写计划投放金额和假设归因收入,再比较低、基准和高三种情景。假设广告支出为 20,000 沙特里亚尔、归因收入为 60,000 沙特里亚尔,模型中的广告支出回报率(ROAS)为 3.0 倍。它不等于利润或新增收入,也没有计入履约成本、税费等因素。改动币种标签时,不应静默换算数值,也不应暗示有一个特定汇率。测试这个例子不需要真实客户数据、账号或广告平台连接。

只有三个情景时,可以先用浏览器原生的单选控件做基准。如果未来要管理很多已保存的情景,再评估添加搜索和靠近按钮的弹出层能否帮忙。测试时只改这一个选择器,其他字段、算法和结果布局保持不变。事先写下用键盘打开、移动、确认以及关闭而不改变原选择时应发生什么。在这里,切换情景只是修改测算假设,不会启动广告活动、写入广告账户,也不能取代计算器自身的数据校验。建议明确写下试验边界:不要为了让原型看起来更完整而改变结果的存储地点、增加跟踪工具或收集联系信息。若选择器需要这些变更,应分别决策,不把它们放进本次对比。

写清键盘路径及焦点恢复

为每个步骤规定一个可观察的结果。从上一个字段按 Tab,焦点移到情景选择按钮,且有清晰的可见提示。用符合该控件模式的按键打开选择器。如果模式支持,方向键可移动当前选项,键入字符可用来定位。屏幕阅读器应能正确传达控件名称、状态和已选值。确认选项后,测算表更新,焦点保持在规定的位置。按 Escape 会关闭打开的选择器而不改值,并在触发按钮仍存在时把焦点还给它。

接着测试演示里经常被略过的情况。弹出层开启时,如果某个情景被删除,焦点要落到邻近且稳定的控件,而不是消失在页面中。没有匹配项时,访客需要理解空状态,并且能找到退出方式。如果输入格式不合法,提示应明确指出相应字段,并保留其他输入。还要试试访客关闭、改变主意、随后重新打开的情况。焦点与已保存的值是两个独立状态,保留其中一个,不代表另一个也已经处理正确。

不只验证布局,还要验证语言和设备

分别在由右向左的阿拉伯语页面和由左向右的英语页面上做同一任务。译后的标签仍要好懂,按钮不能超出视口,混排的拉丁字母、币种及小数要与正确的字段关联。不要把所有方向键都倒过来:垂直列表依然按列表次序上下移动,明确横向排列的控件则应有适合其模式的方向规则。验证阿拉伯语标签换行以及不同的小数分隔习惯。即使界面交互正常,布局与输入解析也可能各有问题。

在窄屏手机上,唤出屏幕键盘,把选择器放在可用空间变小的视口底部附近测试。放大文字、滚动或旋转设备之后,选择器仍应易读、可关闭。用手机的屏幕阅读器检查当前选项和更新后的结果能否区分,同时避免将焦点强行移出正在编辑的字段。桌面键盘与手机辅助技术是互补的验证手段。复用交互代码及 ARIA 信息并不等于获得无障碍认证,更不能代替对色彩对比度、文案和完整页面的检查。

怎样测量库带来的变化?

让原生控件或近似现有实现的基准方案,与测试版原型在相同任务和设备上比较。统计从开始实现到审核及修复所花的工程时间,而不是只记做到首次演示的时间。另行记录选择与取消是否成功、焦点是否恢复,以及审核后仍存在多少缺陷。报告时给出分母和适用范围:小规模原型试用中,8 次键盘操作成功 6 次,只能说明这些尝试,不能代表所有访客。即使平均值不错,无法用键盘退出这类严重问题也必须解决。

避免不公平的比较。例如,不应把熟悉新原型的开发者与第一次接触基准版本的参与者放在一起比较用时。任务表述相同的情况下,可以交换试用顺序,以减少熟练度的影响。如果没有记录到事件,要区分埋点缺失和用户主动放弃。还要把交互任务完成与之后的商业结果分开。一个好用的选择器可能减少操作阻力,却不能证明收入增长。选中乐观情景后模型 ROAS 升高,反映的是假设变化,而非广告表现变好。

保留撤回上线决策的余地

在试验前设定停止条件:如果焦点恢复更不可靠、团队无法持续维护,或增加的复杂度超过任务所需,就保留原交互。通过小试只说明可考虑扩大内部测试,不意味着可以替换所有表单。依赖或设计系统变更后应复测,交接也要明确由谁负责。如果机构有必须遵守的无障碍要求,仍要保留正式审核和签核流程,不以智能体的自评替代责任团队的判断。

给编程智能体的有用指令不是“加点交互”,而是“确保键盘和触控都能选,取消时保留已确认的值,焦点按规则返回,并展示阿拉伯语和英语布局上的验证结果”。即使最终判断原生控件已经足够,这份行为约定仍然有用。Vercel Labs UI SDK 扩大了团队能评估的实现选项,工作流程、给用户的承诺以及上线前需要的证据,仍要由团队负责。

来源