JavaScript Web Component是什么?如何自定义HTML元素
时间:2026-05-16 08:37:26 251浏览 收藏
JavaScript Web Component 是浏览器原生支持的、无需框架即可构建可复用、强封装性自定义 HTML 元素的技术方案,由 Custom Elements(定义行为与生命周期)、Shadow DOM(实现样式与结构的真正隔离)和 HTML Templates(提升模板可维护性与性能)三大核心 API 协同工作;它让你像使用标准标签一样自由创建如 `` 这样的语义化组件,通过继承 `HTMLElement`、命名含短横线、`customElements.define()` 注册,并结合 `attributeChangedCallback` 响应属性变化、`attachShadow` 启用作用域隔离、`` + ` ` 实现清晰的内容分发——真正意义上让 HTML 拥有“扩展能力”,既轻量又面向未来。

JavaScript Web Component 是一套浏览器原生支持的 API,用于创建可复用、封装良好的自定义 HTML 元素。它不是框架,也不依赖第三方库,而是由 Custom Elements、Shadow DOM 和 HTML Templates 三部分组成,让开发者能像使用 或 那样,定义并使用自己的标签,比如 或 。
如何注册一个自定义元素(Custom Element)
必须继承 HTMLElement,并用 customElements.define() 注册。名称中必须包含短横线(-),这是强制规则,防止与未来 HTML 标准冲突。
- 定义类:例如
class MyCard extends HTMLElement { ... } - 添加生命周期钩子:如
connectedCallback()(插入 DOM 时触发)、disconnectedCallback()(移除时)、attributeChangedCallback()(属性变更时) - 注册:调用
customElements.define('my-card', MyCard),之后就能在 HTML 中写
如何用 Shadow DOM 封装样式和结构
Shadow DOM 提供真正的作用域隔离——内部样式不会泄漏到外部,外部 CSS 也不会影响内部渲染,避免全局污染。
- 在
constructor()或connectedCallback()中调用this.attachShadow({ mode: 'open' }) mode: 'open'允许 JS 从外部访问 shadow root;'closed'则禁止(一般不用)- 把模板内容或手动创建的节点 append 到
this.shadowRoot,例如:this.shadowRoot.innerHTML = 'Hello
'
如何支持属性和响应式更新
自定义元素可通过 HTML 属性传参,并监听变化自动更新 UI。关键在于声明 observedAttributes 静态 getter 并实现 attributeChangedCallback。
- 在类中添加:
static get observedAttributes() { return ['title', 'disabled']; } - 在
attributeChangedCallback(name, oldValue, newValue)中处理逻辑,比如更新 shadow 内容或切换 class - 注意:只有已声明的属性才会触发该回调;布尔属性(如
disabled)值为''或null,需用this.hasAttribute('disabled')判断
如何用 HTML Template 提升可读性和性能
把结构和样式提前写在 标签里,避免拼接字符串,也便于复用和维护。
- 在 HTML 中定义:
- 在 JS 中获取:
const tpl = document.getElementById('my-card-tpl').content.cloneNode(true) - 用
slot实现内容分发(类似 Vue 的 slot 或 React 的 children),支持具名插槽如
好了,本文到此结束,带大家了解了《JavaScript Web Component是什么?如何自定义HTML元素》,希望本文对你有所帮助!关注golang学习网公众号,给大家分享更多文章知识!
相关阅读
更多>
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
最新阅读
更多>
-
文章 · 前端 | 6小时前 | 定时器 · 前端 · 性能排查 · 接口请求 · 轮询 · setInterval · setInterval 页面可见性 clearInterval 前端轮询 请求堆积 定时器清理490 收藏
-
253 收藏
-
295 收藏
-
128 收藏
-
365 收藏
-
350 收藏
-
文章 · 前端 | 1天前 | 前端 · javascript · URL参数 · 列表筛选 · 页面状态 · 前端 筛选条件 列表页 history.replaceState URLSearchParams 刷新还原348 收藏
-
458 收藏
-
124 收藏
-
文章 · 前端 | 3天前 | 前端 · javascript · sourcemap · 错误监控 · 线上排查 · 前端 错误监控 告警 onerror sourcemap unhandledrejection331 收藏
-
480 收藏
-
文章 · 前端 | 3天前 | 前端 · 性能优化 · javascript · 图片优化 · IntersectionObserver · 前端 性能优化 图片懒加载 IntersectionObserver Web性能 首屏优化184 收藏
课程推荐
更多>
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习