Web Components 让人不必绑定框架就能封装组件,但「能封装」和「该封装」之间还有一段距离。语义、焦点与可访问名称不会因为套了一层标签就自动变好。
01原生能力的适用面
customElements、shadow DOM、template 与 slot 适合封装那些跨框架复用、生命周期明确、需要样式隔离的部件,比如设计系统里的基础控件。优势是接口稳定、不随框架版本迁移;代价是样式穿透、表单参与、服务端渲染与 SEO 都要额外处理,团队需要为此建立配套约定,而不是只写一个 define 就结束。
如果只能做一件事,就为「自定义元素」写一段最小可运行的代码,亲手在键盘和窄屏上走一遍。很多规范条款读起来抽象,一旦落到真实操作路径上,哪些是必需、哪些只是习惯,很快就能分清楚。
02别把原生控件包成空壳
最常见的反模式是用一个自定义元素包住 div,再自己模拟按钮的点击与状态。原生 button、input、select 已经提供了名称、角色、键盘、表单提交与自动填充;若必须包装,应优先让自定义元素继承或复用原生语义,并补齐 ARIA 与焦点转发。否则封装越漂亮,可访问性树里留下的空洞越大。
如果只能做一件事,就为「自定义元素」写一段最小可运行的代码,亲手在键盘和窄屏上走一遍。很多规范条款读起来抽象,一旦落到真实操作路径上,哪些是必需、哪些只是习惯,很快就能分清楚。
03可访问性与影子边界
影子根会让部分查询与标签关联方式失效,跨边界的 aria-labelledby、label for 需要改用内部方案或 ElementInternals 提供的表单关联能力。组件文档里应明确列出暴露的属性、插槽、事件与焦点行为,并给出键盘操作示例。把这些写清楚,比反复强调「我们用了 Web Components」更能说明组件是否真的可复用。
如果只能做一件事,就为「自定义元素」写一段最小可运行的代码,亲手在键盘和窄屏上走一遍。很多规范条款读起来抽象,一旦落到真实操作路径上,哪些是必需、哪些只是习惯,很快就能分清楚。
要点速览
- 适合跨框架、生命周期清晰、需要样式隔离的基础部件
- 优先复用原生控件语义,避免 div 模拟按钮与表单
- 影子边界会影响 label 关联与 ARIA 引用
- ElementInternals 可补齐表单参与能力
组件化的目标是可复用,不是把语义藏起来。
