0

0

JavaScript自定义元素开发

狼影

狼影

发布时间:2025-11-06 15:20:02

|

169人浏览过

|

来源于php中文网

原创

自定义元素是Web Components核心功能,通过继承HTMLElement并使用customElements.define()注册,可创建可复用、封装性强的自定义标签;需注意标签名含连字符、确保定义后再使用,并推荐Shadow DOM隔离样式,还支持属性监听与原生元素扩展,提升组件化开发效率。

javascript自定义元素开发

自定义元素是 Web Components 的核心功能之一,允许开发者通过 JavaScript 定义自己的 HTML 标签。使用自定义元素可以封装可复用的组件,提升代码组织性与可维护性。在 JavaScript 中创建自定义元素主要依赖于 CustomElementRegistry 接口,通过 customElements.define() 方法注册新元素。

定义自定义元素的基本步骤

要创建一个自定义元素,需要继承 HTMLElement 基类,并在其中添加所需的行为和结构。

以下是基本流程:
  • 创建一个类并继承 HTMLElement
  • 在构造函数中调用 super(),这是必须的
  • 可选:使用 Shadow DOM 封装内部结构与样式
  • 通过 customElements.define() 注册元素,标签名必须包含连字符(-)

示例代码:

class MyCard extends HTMLElement {
  constructor() {
    super();
    // 创建 Shadow DOM 来隔离样式和结构
    this.attachShadow({ mode: 'open' });
    this.shadowRoot.innerHTML = `
      
      
`; } }

// 注册自定义元素 customElements.define('my-card', MyCard);

使用方式:

立即学习Java免费学习笔记(深入)”;

这是一张自定义卡片

支持属性与响应式更新

为了让自定义元素对属性变化做出反应,可以利用静态 getter observedAttributesattributeChangedCallback 方法。

实现方式如下:
  • 在类中定义 static get observedAttributes() 返回需监听的属性数组
  • 实现 attributeChangedCallback(name, oldVal, newVal) 处理变更逻辑
  • 可结合 connectedCallback 在元素插入 DOM 时初始化状态

示例:支持 title 属性

class MyCard extends HTMLElement {
  static get observedAttributes() {
    return ['title'];
  }

constructor() { super(); this.attachShadow({ mode: 'open' }); }

connectedCallback() { this.render(); }

attributeChangedCallback(name, oldVal, newVal) { if (name === 'title') { this.render(); } }

render() { const title = this.getAttribute('title') || '默认标题'; this.shadowRoot.innerHTML = zuojiankuohaophpcnstyle> .card { border: 1px solid #ddd; padding: 16px; margin: 8px; border-radius: 8px; background: #f9f9f9; } h3 { margin-top: 0; color: #333; } zuojiankuohaophpcn/style> zuojiankuohaophpcndiv class="card"> zuojiankuohaophpcnh3>${title}zuojiankuohaophpcn/h3> zuojiankuohaophpcnslot>zuojiankuohaophpcn/slot> zuojiankuohaophpcn/div> ; } }

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

使用:

商城购物系统
商城购物系统

商城购物系统是一个以php+MySQL进行开发的可塑性极强的电子商品平台;商城购物系统可自定义商品栏目内容,包含分销功能,分销管理、分销订单提成完整功能,商品加购物车、商品支付、商品发货等一系列流程,包括pc端和手机H5端。

下载
用户名:Alice

内建元素扩展(增强原生标签)

除了创建全新标签,还可以扩展原生 HTML 元素,比如增强按钮或输入框。

方法是:
  • 继承对应元素的接口,如 HTMLButtonElement
  • 注册时传入第三个参数 { extends: 'button' }
  • 使用时通过 is 属性指定行为

示例:扩展 button

class FancyButton extends HTMLButtonElement {
  constructor() {
    super();
    this.addEventListener('click', () => {
      alert('点击了炫酷按钮!');
    });
  }
}

customElements.define('fancy-button', FancyButton, { extends: 'button' });

使用:

这种方式保持语义化的同时增加功能。

注意事项与兼容性

开发时注意以下几点:

  • 自定义标签名必须包含连字符,避免与未来 HTML 标准冲突
  • 确保在使用前完成元素定义,否则会报错
  • Shadow DOM 提供样式隔离,推荐使用以避免污染全局
  • 现代浏览器广泛支持,但老版本 IE 不兼容,生产环境建议配合 polyfill 或构建工具处理

基本上就这些。掌握自定义元素后,你可以构建高度封装、可复用的组件,为前端架构提供更强的灵活性。

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

556

2023.06.20

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

374

2023.07.04

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

733

2023.07.04

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

477

2023.09.01

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

414

2023.09.04

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

991

2023.09.04

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

658

2023.09.12

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

553

2023.09.20

PS使用蒙版相关教程
PS使用蒙版相关教程

本专题整合了ps使用蒙版相关教程,阅读专题下面的文章了解更多详细内容。

23

2026.01.19

热门下载

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

精品课程

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

共58课时 | 3.8万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 2.3万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.9万人学习

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

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