0

0

Web组件开发规范_Custom Elements与Shadow DOM

紅蓮之龍

紅蓮之龍

发布时间:2025-12-03 19:35:02

|

404人浏览过

|

来源于php中文网

原创

custom elements 与 shadow dom 是 web 组件核心技术,前者用于定义自定义标签并控制行为,后者实现样式和结构隔离。1. custom elements 通过继承 htmlelement 并调用 customelements.define() 注册,标签名需含短横线以避免冲突;2. shadow dom 通过 attachshadow() 挂载,提供独立 dom 子树,防止样式互相影响,mode 可设为 open 或 closed 以控制访问权限;3. 结合使用时应采用语义化命名、利用 slot 内容分发、监听属性变化更新 ui,并将样式置于 shadow dom 内部以确保封装性,适用于现代浏览器,可构建不依赖框架的高复用性组件。

web组件开发规范_custom elements与shadow dom

在现代前端开发中,Web组件提供了一种构建可复用、封装性强且无需依赖框架的UI组件的方式。其中,Custom Elements 和 Shadow DOM 是 Web 组件的两大核心技术。它们让开发者可以创建自定义 HTML 标签,并为其添加独立的样式和行为,实现真正的组件化开发。

Custom Elements:定义自定义标签

Custom Elements 允许开发者定义自己的 HTML 元素,并通过 JavaScript 控制其行为。浏览器原生支持这类元素,无需引入额外库。

要创建一个 Custom Element,需继承 HTMLElement 并使用 customElements.define() 方法注册。

class MyButton extends HTMLElement {
  constructor() {
    super();
    // 初始化内容或属性
    this.textContent = this.getAttribute('label') || '默认按钮';
  }

  // 可监听属性变化
  static get observedAttributes() {
    return ['label'];
  }

  attributeChangedCallback(name, oldValue, newValue) {
    if (name === 'label') {
      this.textContent = newValue;
    }
  }
}

customElements.define('my-button', MyButton);

使用方式:

注意命名规则必须包含短横线(-),如 my-button,这是为了避免与标准 HTML 标签冲突。

Shadow DOM:实现样式与结构的隔离

Shadow DOM 提供了一个独立的 DOM 子树,与主文档 DOM 隔离。这意味着组件内部的样式不会影响外部页面,外部样式也不会污染组件内部。

通义灵码
通义灵码

阿里云出品的一款基于通义大模型的智能编码辅助工具,提供代码智能生成、研发智能问答能力

下载

在 Custom Element 构造函数中,可通过 attachShadow() 方法挂载 Shadow DOM。

class MyCard extends HTMLElement {
  constructor() {
    super();
    const shadow = this.attachShadow({ mode: 'open' });

    shadow.innerHTML = <br>       <style><br>         .card {<br>           border: 1px solid #ddd;<br>           padding: 16px;<br>           border-radius: 8px;<br>           background: #f9f9f9;<br>         }<br>       </style><br>       <div class="card"><br>         <slot></slot> <!-- 插槽,允许传入内容 --><br>       </div><br>     ;
  }
}

customElements.define('my-card', MyCard);

使用方式:


  这是一段卡片内容。

Shadow DOM 的 mode 可设为 openclosed。设为 open 时,JavaScript 可通过 element.shadowRoot 访问内部结构;closed 则不可访问,增强封装性。

结合使用建议与最佳实践

将 Custom Elements 与 Shadow DOM 结合,是构建高内聚、低耦合组件的标准方式。以下是一些实用建议:

  • 始终使用语义化的自定义标签名,例如 user-avatardata-table
  • 利用 实现内容分发,提升组件灵活性
  • 避免在构造函数中执行耗时操作,DOM 渲染可能受影响
  • 合理使用 observedAttributes 监听属性变化,更新 UI
  • 样式写在 Shadow DOM 内部,防止全局污染
  • 考虑兼容性:现代主流浏览器均支持,但旧版 IE 不行

基本上就这些。掌握 Custom Elements 与 Shadow DOM,能让你写出真正解耦、可复用的原生 Web 组件,不依赖 React 或 Vue 也能实现组件化开发。不复杂但容易忽略的是细节,比如标签命名和 Shadow DOM 模式选择。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
typedef和define区别
typedef和define区别

typedef和define区别在类型检查、作用范围、可读性、错误处理和内存占用等。本专题为大家提供typedef和define相关的文章、下载、课程内容,供大家免费下载体验。

119

2023.09.26

define的用法
define的用法

define用法:1、定义常量;2、定义函数宏:3、定义条件编译;4、定义多行宏。更多关于define的用法的内容,大家可以阅读本专题下的文章。

361

2023.10.11

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

841

2023.08.22

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

558

2023.09.20

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

788

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

25

2025.12.06

DOM是什么意思
DOM是什么意思

dom的英文全称是documentobjectmodel,表示文件对象模型,是w3c组织推荐的处理可扩展置标语言的标准编程接口;dom是html文档的内存中对象表示,它提供了使用javascript与网页交互的方式。想了解更多的相关内容,可以阅读本专题下面的文章。

4212

2024.08.14

css中的padding属性作用
css中的padding属性作用

在CSS中,padding属性用于设置元素的内边距。想了解更多padding的相关内容,可以阅读本专题下面的文章。

175

2023.12.07

Rust内存安全机制与所有权模型深度实践
Rust内存安全机制与所有权模型深度实践

本专题围绕 Rust 语言核心特性展开,深入讲解所有权机制、借用规则、生命周期管理以及智能指针等关键概念。通过系统级开发案例,分析内存安全保障原理与零成本抽象优势,并结合并发场景讲解 Send 与 Sync 特性实现机制。帮助开发者真正理解 Rust 的设计哲学,掌握在高性能与安全性并重场景中的工程实践能力。

19

2026.03.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Django 教程
Django 教程

共28课时 | 4.8万人学习

React 教程
React 教程

共58课时 | 5.8万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号