给表单加了
disabled,鼠标点不动输入框,看起来已经「禁用」了。但按 Tab——焦点落在了下拉框的触发器上;按 Enter——下拉打开了;按方向键 + Enter——值被改成了「技术部」。表单是禁用的,数据却变了。这不是表单库的 bug,是
fieldset[disabled]的适用范围和 CSS 的pointer-events都被高估了。这次的问题不是没禁用,而是只禁用了半个。
最小复现
<Form :model="form" disabled>
<FormItem label="姓名" prop="name">
<Input v-model="form.name" />
</FormItem>
<FormItem label="部门" prop="dept">
<Select v-model="form.dept" :options="depts" />
</FormItem>
</Form>
Input 渲染的是原生 <input>,Select 渲染的是 <div role="combobox" tabindex="0"> 加一个 Teleport 到 body 的面板。同一句 disabled,一个生效,一个不生效。
实测(0.2.29 / 0.2.30,同一套操作):
| 操作 | 0.2.29 | 0.2.30 |
|---|---|---|
| Tab 序列 | 下拉触发器 → 外部按钮 | 直接到外部按钮 |
| 聚焦下拉按 Enter | 打开 | 不打开 |
| 方向键 + Enter | 选中「技术部」 | 仍是「请选择部门」 |
| 原生输入框打字 | 值不变(fieldset 原生禁用) | 值不变 |
fieldset.inert | false | true |
注意第三行:原生输入框其实是被 fieldset[disabled] 保护住的,真正漏掉的是自定义下拉。
这个场景在「提交中禁用表单」里最常见:点提交后把表单置灰防止重复提交,但键盘用户仍能改下拉,请求发出去的是改后的值。鼠标用户看到的是灰的,键盘用户看到的是能用的——两个用户拿到不同的表单。更危险的是「看起来禁用」:产品以为锁住了,实际只锁了鼠标。
为什么 fieldset 管不住下拉
HTML 规范里,fieldset[disabled] 会禁用它的后代表单控件——button、input、select、textarea 等原生元素。Select 的触发器是一个 div:
<div class="rn-select__trigger" role="combobox" tabindex="0" @keydown="onKeydown">
div 不是表单控件,fieldset[disabled] 对它没有任何约束;tabindex="0" 让它照样进 Tab 序列,@keydown 让它照样响应 Enter/方向键。于是「禁用表单」只禁用了表单里的一半。
从读屏视角看也一样:fieldset[disabled] 会让原生控件从可访问树里消失,但 div 触发器还在,读屏仍会念「组合框,请选择部门」。
CSS 这边,原来的写法是:
.rn-form--disabled {
pointer-events: none;
}
pointer-events 只拦截指针事件(鼠标、触摸、触控笔)。键盘事件不经过指针,element.focus() 也不经过指针,所以键盘和脚本都能绕过去。
顺便说一句:<form disabled> 不是合法属性,浏览器会直接忽略;disabled 只有 fieldset 和单个表单控件支持。在 form 上写它,看起来像禁用了,实际什么都没发生。
浏览器内部维护了一份表单控件列表(button、input、select、textarea、fieldset 等),fieldset[disabled] 按这份列表逐项生效;列表之外的节点,属性写得再多也不会被纳入。
所以浏览器判断一个元素是不是 form control,看的是元素类型,不是 role。给 div 加 role="combobox"、aria-disabled="true",都不会让它进入 fieldset 的管辖范围;这些属性只影响读屏语义,不影响浏览器的禁用逻辑。
源码:disabled 提供了,但没人消费
Form 把 disabled 放进了 provide:
provide(rnFormKey, {
model: props.model,
rules: computed(() => props.rules),
disabled: computed(() => props.disabled),
// ...
});
但 FormItem 和各个控件只注入了 rnFormItemKey(用于触发校验),没有读 rnFormKey.disabled。也就是说,这个上下文里的 disabled 目前没有消费者——真正生效的是模板上的 fieldset :disabled,而它只覆盖原生控件。
Select 自己的 onKeydown 里其实有守卫:
function onKeydown(event: KeyboardEvent) {
if (props.disabled) return; // 只看组件自己的 prop
// ...
}
问题在于 props.disabled 来自 Select 自己的 prop,Form 的 disabled 没有传给它,所以这个守卫永远是 false。
要彻底修,有两条路:
- 让每个控件都读
rnFormKey.disabled,合并到自己的disabled; - 用
inert把整棵子树一次性变成不可交互。
第一种要改十几个组件,还覆盖不了用户塞进插槽里的第三方控件;第二种一行属性就能覆盖所有后代。
修法:inert + aria-disabled
<fieldset
class="rn-form"
:class="[...]"
:disabled="disabled"
:inert="disabled || undefined"
:aria-disabled="disabled || undefined"
>
完整写法:
<fieldset
class="rn-form"
:class="[`rn-form--label-${labelPosition}`, { 'rn-form--disabled': disabled }]"
:disabled="disabled"
:inert="disabled || undefined"
:aria-disabled="disabled || undefined"
>
<slot />
</fieldset>
三个属性各管一件事:
disabled:原生控件继续由浏览器禁用,保留原生视觉与行为;inert:整棵子树不可聚焦、不可点击、不可被辅助技术操作,键盘和脚本都进不去;aria-disabled:给读屏一个明确的状态,即使焦点因为某些原因落在容器上。
inert 在规范里做的事不止「不能点」:子树不能聚焦(包括脚本 focus())、不在 Tab 序列、辅助技术视为不可用、文本不能被选中、页内查找也找不到。一条属性把六件事一起做了,这是它比「pointer-events + 遍历 tabindex」更可靠的原因。
保留 pointer-events: none 作为旧浏览器兜底:不支持 inert 的环境(Chrome < 102、Firefox < 112、Safari < 15.5)至少鼠标还是点不动。
要不要在运行时检测支持情况,可以这样写:
const supportsInert =
typeof HTMLElement !== "undefined" && "inert" in HTMLElement.prototype;
inert 不可用的环境里,键盘仍会漏;要么引入 polyfill,要么业务层在禁用时手动把内部可聚焦元素的 tabindex 设为 -1——后者又要遍历子树,正是 inert 想省掉的事。
为什么不用「aria-disabled + 遍历 tabindex」:遍历能挡住 Tab,但挡不住脚本 focus()、拖拽、选中和读屏;表单内容异步变化时还要重复遍历。inert 由浏览器维护,子树变化自动生效。
实测 0.2.30:fieldset.inert === true,Tab 序列只剩外部按钮,document.querySelector('input').focus() 之后 activeElement 仍是 body,下拉无法打开、也无法改值。
为什么不用「把 disabled 传给每个子组件」
| 方案 | 覆盖范围 | 代价 |
|---|---|---|
CSS pointer-events | 只挡鼠标 | 键盘、脚本、读屏全部绕过 |
fieldset[disabled] | 只覆盖原生表单控件 | 自定义 div 控件漏掉 |
逐组件传 disabled | 覆盖已知组件 | 改十几个组件;插槽里的第三方控件仍漏 |
inert(现方案) | 整棵 DOM 子树 | 旧浏览器需兜底;Teleport 浮层不在子树内 |
三种错误/正确写法的对比:
<!-- 无效:form 没有 disabled 属性,浏览器忽略 -->
<form disabled>...</form>
<!-- 只挡鼠标:键盘、脚本 focus、读屏都能绕过 -->
<fieldset class="rn-form--disabled">...</fieldset>
<!-- 正确:inert 覆盖整棵子树,aria-disabled 给读屏 -->
<fieldset :disabled="disabled" :inert="disabled || undefined" :aria-disabled="disabled || undefined">
...
</fieldset>
第四行的「Teleport 浮层」是这套方案唯一的边界:Select 的下拉面板被传送到 body,不在 fieldset 子树里。如果下拉已经打开时把表单切成禁用,面板仍在 body 上,理论上还能点。我们的做法是禁用时让触发器失焦(inert 会让当前焦点移出),但更稳妥的业务做法是:切禁用前先关闭所有浮层,或者给浮层也加 inert。
watch(() => form.disabled, (disabled) => {
if (disabled) selectRef.value?.close(); // 组件暴露的 close
});
如果禁用发生时焦点正在表单内,inert 会把焦点移出到 body。对键盘用户来说焦点突然丢失,体验不好;更稳妥的是切禁用前主动把焦点移到表单外的第一个可聚焦元素,或者移到「提交中」的状态提示上。
我以为是 A,实测是 B
第一处:我以为 fieldset[disabled] 会禁用里面所有控件。实测原生 <input> 确实被禁用(打字不进值),但 Select 的 div 触发器照样 Tab 得到、Enter 打得开、方向键改得了值。
第二处:我以为 pointer-events: none 已经够了。实测它只挡鼠标;键盘焦点、focus()、回车键完全不经过它。
第三处:我以为给容器加 aria-disabled 就够了。实测它只是给读屏的语义,不阻止任何操作——不加 inert 的话,键盘照样能改值。
第四处:我以为 inert 会把 Teleport 出去的面板一起禁用。实测 Teleport 的目标是 body,不在 fieldset 子树内,inert 管不到;这是 inert 的边界,不是它的 bug。
测试怎么写
单测只能验证属性契约(jsdom 不实现 inert 的交互行为):
it("disabled 时 fieldset 带 inert 与 aria-disabled", () => {
const disabled = mount(Form, { props: { model: { name: "" }, disabled: true } });
const el = disabled.find("fieldset");
expect(el.attributes("inert")).toBeDefined();
expect(el.attributes("aria-disabled")).toBe("true");
const enabled = mount(Form, { props: { model: { name: "" } } });
expect(enabled.find("fieldset").attributes("inert")).toBeUndefined();
});
这类断言不能只写在单测里:jsdom 不实现 inert 的交互行为,属性断言只能证明写法,浏览器断言才能证明行为。Tab 序列可以直接记录:
const seq = [];
for (let i = 0; i < 4; i++) {
await page.keyboard.press("Tab");
seq.push(await page.evaluate(() =>
document.activeElement?.className || document.activeElement?.tagName));
}
// 0.2.29: ["rn-select__trigger", "outside", ...]
// 0.2.30: ["outside", ...]
完整的四条:
- 从页面开头按 Tab,连续记录
document.activeElement,表单内控件一个都不应出现; input.focus()后读activeElement,仍是body;- 聚焦下拉触发器按 Enter,
document.querySelector('.rn-select__dropdown')应为 null; - 强行派发方向键 + Enter,选中值不应变化。
第 3 条可以直接写成脚本断言:
await page.evaluate(() => document.querySelector(".rn-select__trigger")?.focus());
await page.keyboard.press("Enter");
const opened = await page.evaluate(() => !!document.querySelector(".rn-select__dropdown"));
// 0.2.29: opened === true
// 0.2.30: opened === false
这套断言在 0.2.29 上跑:Tab 落在下拉触发器、Enter 打开面板、方向键选中「技术部」——全部复现;0.2.30 上 10/10 通过。
aria-disabled 和 inert 的分工也要说清楚:前者是语义,告诉读屏「这里是禁用的」;后者是行为,真正拦住焦点与事件。只写 aria-disabled,读屏会说「已禁用」,键盘却能操作——语义与行为不一致,比不写更糟。
结果
0.2.30 发布:
- Form 在
disabled时补inert与aria-disabled,整棵子树不可聚焦、不可交互; - 保留
fieldset[disabled]与pointer-events: none作为原生控件与旧浏览器兜底; - 单测 936 → 937,新增 inert/aria-disabled 契约用例;
- 真机 10/10:Tab 序列从「下拉 → 外部」变为只剩外部,程序聚焦失效,下拉打不开也改不了值;
- 文档「全局禁用」示例改成可切换:按钮切禁用/启用,旁边实时显示「已禁用(inert)/ 可编辑」;
- 共 12 张对照图,覆盖禁用前后与线上示例。
结论
「禁用」不是给容器加一个 class,而是要让所有输入方式都停下来。三种手段的能力边界:
| 手段 | 鼠标 | 键盘 | 脚本 focus | 读屏 |
|---|---|---|---|---|
pointer-events: none | 拦住 | 绕过 | 绕过 | 无感知 |
fieldset[disabled] | 拦住 | 原生控件拦住,自定义控件绕过 | 同左 | 原生控件可感知 |
aria-disabled | 不拦 | 不拦 | 不拦 | 可感知 |
inert | 拦住 | 拦住 | 拦住 | 可感知 |
一句话选择:要真正禁用一棵子树,用 inert;disabled 只适合单个原生控件,aria-disabled 只负责语义,pointer-events 只负责鼠标。
验收标准也很简单:把鼠标拔掉,只用键盘走一遍;再打开读屏走一遍。Tab 不进去、回车没反应、读屏说「已禁用」,三条都过才是真禁用。
最后留一个检查项:禁用发生时,Teleport 到 body 的浮层不在 inert 子树内,记得主动关闭。
上线前自查五项:1)Tab 能不能穿过禁用表单;2)脚本 focus() 是否失败;3)已打开的浮层是否关闭;4)读屏是否播报禁用;5)不支持 inert 的浏览器降级是否可接受。
组件解剖 · 系列目录
- Table:虚拟滚动的三个硬约束
- Transfer:三态复选框的三个 bug
- Select:可搜索下拉的键盘、ARIA 与滚动
- Carousel:自动播放的暂停机制与播报时机
- 验证码:v-model 的三种假同步
- Form(本篇):fieldset、pointer-events 与 inert 的边界