表单设了 disabled,下拉还能用键盘改值:fieldset 只挡住了原生控件

0 阅读9分钟

给表单加了 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.290.2.30
Tab 序列下拉触发器 → 外部按钮直接到外部按钮
聚焦下拉按 Enter打开不打开
方向键 + Enter选中「技术部」仍是「请选择部门」
原生输入框打字值不变(fieldset 原生禁用)值不变
fieldset.inertfalsetrue

注意第三行:原生输入框其实是被 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。

要彻底修,有两条路:

  1. 让每个控件都读 rnFormKey.disabled,合并到自己的 disabled;
  2. 用 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", ...]

完整的四条:

  1. 从页面开头按 Tab,连续记录 document.activeElement,表单内控件一个都不应出现;
  2. input.focus() 后读 activeElement,仍是 body;
  3. 聚焦下拉触发器按 Enter,document.querySelector('.rn-select__dropdown') 应为 null;
  4. 强行派发方向键 + 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 张对照图,覆盖禁用前后与线上示例。

0.2.29:表单 disabled,fieldset 有 disabled 但没有 inert

按 Tab:焦点落在下拉触发器上,外部按钮在后面

原生输入框被 fieldset 禁用,脚本聚焦失败、打字不进值

聚焦下拉按 Enter:面板照样打开

方向键 + Enter:禁用表单里选中了「技术部」

0.2.30:fieldset 同时带 inert 与 aria-disabled

按 Tab:表单内控件全部跳过,直接到外部按钮

脚本聚焦输入框失败,activeElement 仍是 body

聚焦下拉按 Enter:面板不打开

方向键 + Enter:选中值保持「请选择部门」

线上示例(0.2.30):全局禁用,状态显示「已禁用(inert)」

点「启用表单」后:状态变为「可编辑」,控件恢复

结论

「禁用」不是给容器加一个 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 的边界

在线示例:ui.ruanno.top/components/… 源码:gitee.com/ruanno-top/…