如何从头开始构建简单的 Web 组件-js教程-PHP中文网

首页

web前端

js教程

如何从头开始构建简单的 Web 组件

Barbara Streisand

Jan 23, 2025 am 01:00 AM

本指南演示了构建可重用的 Web 组件：一个简单的计数器。我们将利用自定义元素、Shadow DOM 和 HTML 模板。完成的计数器将具有用于增加和减少显示数值的按钮。

How to Build a Simple Web Component from Scratch

此代码的完整、可运行版本可以在此处。

先决条件：

熟悉基本的 JavaScript 和对 DOM（文档对象模型）的概念性理解会很有帮助，尽管不是严格要求。

项目设置：

创建两个文件：counter.html（包含页面结构）和 counter.js（包含自定义元素定义）。

counter.html（初始结构）：

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width">
  <title>Counter Component</title>
</head>
<body>
  <script src="counter.js"></script>
</body>
</html>

创建模板（counter.html - 添加模板）：

我们将使用 HTML 模板定义计数器的视觉结构：

<template id="x-counter">
  <button id="min-btn">-</button>
  <span id="counter-display">0</span>
  <button id="plus-btn">+</button>
</template>

该模板不会直接渲染；它充当我们自定义元素的蓝图。

定义自定义元素 (counter.js)：

这段 JavaScript 代码定义了计数器的功能：

class XCounter extends HTMLElement {
  constructor() {
    super();
    this.counter = 0;
    this.elements = {};
  }

  connectedCallback() {
    const template = document.getElementById("x-counter");
    this.attachShadow({ mode: "open" });
    this.shadowRoot.appendChild(template.content.cloneNode(true));
    this.elements = {
      plusBtn: this.shadowRoot.querySelector("#plus-btn"),
      minBtn: this.shadowRoot.querySelector("#min-btn"),
      counterDisplay: this.shadowRoot.querySelector("#counter-display")
    };
    this.displayCount();
    this.elements.plusBtn.onclick = () => this.increment();
    this.elements.minBtn.onclick = () => this.decrement();
  }

  increment() {
    this.counter++;
    this.displayCount();
  }

  decrement() {
    this.counter--;
    this.displayCount();
  }

  displayCount() {
    this.elements.counterDisplay.textContent = this.counter;
  }
}

customElements.define("x-counter", XCounter);

这个类扩展了HTMLElement。 connectedCallback 处理元素添加到页面时的设置，包括附加影子 DOM 和事件监听器。 increment、decrement 和 displayCount 管理计数器的值和显示。

使用计数器组件（counter.html - 添加自定义元素）：

要使用计数器，只需将 <x-counter></x-counter> 添加到您的 HTML 中即可。

设置组件样式（counter.js - 添加样式）：

使用 adoptedStyleSheets 将样式封装在组件内：

connectedCallback() {
  // ... (previous code) ...
  const sheet = new CSSStyleSheet();
  sheet.replaceSync(this.styles());
  this.shadowRoot.adoptedStyleSheets = [sheet];
  // ... (rest of connectedCallback) ...
}

styles() {
  return `
    :host {
      display: block;
      border: dotted 3px #333;
      width: fit-content;
      height: fit-content;
      padding: 15px;
    }
    button {
      border: solid 1px #333;
      padding: 10px;
      min-width: 35px;
      background: #333;
      color: #fff;
      cursor: pointer;
    }
    button:hover {
      background: #222;
    }
    span {
      display: inline-block;
      padding: 10px;
      width: 50px;
      text-align: center;
    }
  `;
}

这添加了包含在影子 DOM 中的基本样式。

结论：

本教程演示了创建一个简单的、可重用的 Web 组件。模板、shadow DOM 和自定义元素的使用促进了 Web 开发的模块化和可维护性。请记住将 [here](https://www.php.cn/link/2eac42424d12436bdd6a5b8a88480cc3) 替换为最终代码的实际链接。

以上是如何从头开始构建简单的 Web 组件的详细内容。更多信息请关注PHP中文网其他相关文章！

声明

本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系admin@php.cn

在JavaScript中替换字符串字符Mar 11, 2025 am 12:07 AM

JavaScript字符串替换方法详解及常见问题解答本文将探讨两种在JavaScript中替换字符串字符的方法：在JavaScript代码内部替换和在网页HTML内部替换。在JavaScript代码内部替换字符串最直接的方法是使用replace()方法： str = str.replace("find","replace"); 该方法仅替换第一个匹配项。要替换所有匹配项，需使用正则表达式并添加全局标志g： str = str.replace(/fi

自定义Google搜索API设置教程Mar 04, 2025 am 01:06 AM

本教程向您展示了如何将自定义的Google搜索API集成到您的博客或网站中，提供了比标准WordPress主题搜索功能更精致的搜索体验。令人惊讶的是简单！您将能够将搜索限制为Y

构建您自己的Ajax Web应用程序Mar 09, 2025 am 12:11 AM

因此，在这里，您准备好了解所有称为Ajax的东西。但是，到底是什么？ AJAX一词是指用于创建动态，交互式Web内容的一系列宽松的技术。 Ajax一词，最初由Jesse J创造

示例颜色json文件Mar 03, 2025 am 12:35 AM

本文系列在2017年中期进行了最新信息和新示例。在此JSON示例中，我们将研究如何使用JSON格式将简单值存储在文件中。使用键值对符号，我们可以存储任何类型的

8令人惊叹的jQuery页面布局插件Mar 06, 2025 am 12:48 AM

利用轻松的网页布局：8个基本插件 jQuery大大简化了网页布局。本文重点介绍了简化该过程的八个功能强大的JQuery插件，对于手动网站创建特别有用

什么是这个＆＃x27;在JavaScript？Mar 04, 2025 am 01:15 AM

核心要点 JavaScript 中的 this 通常指代“拥有”该方法的对象，但具体取决于函数的调用方式。没有当前对象时，this 指代全局对象。在 Web 浏览器中，它由 window 表示。调用函数时，this 保持全局对象；但调用对象构造函数或其任何方法时，this 指代对象的实例。可以使用 call()、apply() 和 bind() 等方法更改 this 的上下文。这些方法使用给定的 this 值和参数调用函数。 JavaScript 是一门优秀的编程语言。几年前，这句话可