创建自定义标签以扩展 HTML 功能

在本教程中,我将向您展示使用自定义标签扩展 html 语言是多么容易。自定义标签可用于实现各种行为,因此它们是编写更少代码并使 html 文档更简单的非常方便的方法。

要进一步了解自定义标签,请查看我关于使用 Shadow DOM 创建封装的自定义标签的文章。

什么是自定义 HTML 标记?

例如,对于 HTML,您可以使用 标记来显示粗体文本。如果您需要列表,则可以对每个列表项使用

    标签及其子标签

  • 。标签由浏览器解释,并与 CSS 一起确定网页内容的显示方式以及部分内容的行为方式。

    有时,仅使用一个 HTML 标签不足以满足 Web 应用程序所需的功能。通常,这是通过使用多个 HTML 标签以及 JavaScript 和 CSS 来解决的,但这种解决方案并不是那么优雅。

    更优雅的解决方案是使用自定义标签 – 中包含的标识符,浏览器会解释该标识符以呈现我们预期的功能。与常规 HTML 标签一样,我们应该能够在页面上多次使用自定义标签,并且还应该能够拥有标签属性和子标签来辅助自定义标签的功能。

    立即学习“前端免费学习笔记(深入)”;

    简单来说,自定义元素可用于解锁以下功能:

  • 定义和构建新的 HTML 元素
  • 构建扩展其他元素的元素
  • 创建可将自定义功能整合到应用程序中的元素
  • 使用现有 DOM 元素并扩展其 API

    在这篇文章中,我们将通过构建一个名为 的自定义标签来了解自定义元素。此自定义标签将显示特定电子邮件地址的 Gravatar 图片。

    现代浏览器中的 customElements API 让这一切变得简单!

    1. 创建项目

    为了实现和测试我们的标签,我们需要创建一些东西:

  • 使用自定义标记的 index.html 文件
  • 一个codingdude-gravatar.js文件来实现自定义标签

    2.修改index.html

    让我们编辑 index.html 文件并使其内容如下所示:

            This is my Gravatar picture:     

    如果我们现在在浏览器中加载 index.html,结果不会那么令人印象深刻,因为我们尚未实现自定义标记的代码。

    需要注意的一件事是浏览器非常宽容,因此您可以在文档中包含未知标签,浏览器将忽略它们。为了让我们的自定义标签真正显示我的电子邮件的 Gravatar 图片,我们必须首先了解 Gravatar 的工作原理。

    3.注册新标签

    第 1 步:选择正确的名称

    为了创建自定义标签,您需要使用 window.customElements.define()

    customElements.define() 中的第一个参数是标记的名称。这就是我们在 HTML 文件中提到的。该名称应始终带有破折号 (-)。名称类似于 的标签无效。这使得解析器应该能够区分常规元素和自定义标签。

    自定义元素标签名称必须始终带有破折号 (-)。

    第 2 步:选择正确的原型

    customElements.define() 有第二个可选对象。该对象用于提及新元素的原型。默认情况下,自定义元素继承自 HTMLElement。上面的代码相当于下面的代码:

    customElements.define("codingdude-gravatar", CodingDudeGravatar);

    如果您希望创建扩展另一个 HTML 元素的自定义元素,则必须在 customElements.define() 中扩展本机元素。继承本机元素的自定义元素也称为“类型扩展自定义元素”。

    customElements.define("codingdude-gravatar", class extends HTMLButtonElement {...});

    还有一些需要注意的事情:

  • 您不能多次注册该标签。如果您尝试这样做,浏览器将抛出 DOMException
  • 自定义元素标签不能自动关闭。

    4.实例化自定义元素

    HTML 元素的所有标准规则都适用于自定义元素。就像标准元素一样,您可以使用 JavaScript 在 DOM 中创建自定义元素,或在 HTML 中声明它。

    在 HTML 中声明自定义元素:

    
    

    使用 JavaScript 在 DOM 中创建自定义元素:

    var codingdudeGravatar = document.createElement('codingdude-gravatar');codingdudeGravatar.addEventListener('click',function(e){});

    在 HTML 中实例化类型扩展元素:

    使用 JavaScript 在 DOM 中创建类型扩展元素:

    var codingdudeGravatar = document.createElement('button', 'codingdude-gravatar');

    5.向自定义标签添加标记

    在自定义标签中添加标记相当简单。首先,您需要创建一个扩展父 HTML 元素的类。在我们的例子中,我们将扩展 HTMLElement。在 HTMLElement 中,我们将使用 constructor 添加事件侦听器并调整自定义标记的 innerText 。记得调用 super() 因为这将有助于继承父类的方法和属性。永远记住,构造函数内的 this 指向创建的自定义元素。

    这是我们组件外观的简单概述。

    class CodingDudeGravatar extends HTMLElement {  constructor() {    super()    this.addEventListener('click', e => {        alert('You Clicked Me!')    });    this.innerText="Hello There!"  }}window.customElements.define('codingdude-gravatar', CodingDudeGravatar);

    6.生命周期方法

    在开始向自定义标记添加标记之前,您需要了解与自定义标记关联的生命周期方法。有四个生命周期回调。

    回调 目的

    构造函数创建自定义标签元素的实例connectedCallback自定义标签元素的实例被插入到文档中disconnectedCallback自定义标签元素的实例从文档中删除attributeChangedCallback(attributeName, oldValue, newValue)添加、删除或更新了自定义标记元素中的属性

    带有这些回调的自定义标记的骨架如下所示:

    class CodingDudeGravatar extends HTMLElement {    constructor() {    super(); // always call super() first in the constructor.    ...    }    connectedCallback() {    ...    }    disconnectedCallback() {    ...    }    attributeChangedCallback(attrName, oldVal, newVal) {    ...    }}

    我们已经了解了如何在自定义元素中使用 构造函数 。现在,让我们在代码中使用其他回调方法!让我们从 connectedCallback 开始。

    connectedCallback

    connectedCallback 可用于检查自定义标记中的电子邮件属性。一旦元素添加到文档中,就会进行此检查。我们将使用 getter 函数来检查 custom tag 是否具有 email 属性。

    class CodingDudeGravatar extends HTMLElement {  get email() {    return this.hasAttribute('email');  }  constructor() {    super()    this.addEventListener('click', e => {        alert('You Clicked Me!')    });    this.innerText="Hello There!"  }  connectedCallback(){    if(this.email){        var email = this.attributes.email.value;        var gravatar = "https://www.gravatar.com/avatar"        this.innerHTML = "创建自定义标签以扩展 HTML 功能
    "+email } else { this.innerHTML = "No Email"; } }}

    当自定义标记插入 HTML 中时,您将看到如下内容:

    
    

    创建自定义标签以扩展 HTML 功能

    但是,当在自定义标签中设置 email 属性时,屏幕将如下所示:

    
    

    创建自定义标签以扩展 HTML 功能

    attributeChangedCallback

    浏览器将为 observedAttributes 数组中列出的所有属性调用生命周期方法 attributeChangedCallback。其背后的目标是提高自定义标签的性能。例如,如果用户决定更改样式,您不希望触发 attributeChangedCallback 。在我们的例子中,我们希望仅当电子邮件更改时才调用 attributeChangedCallback 。为了实现这一点,代码如下所示:

    class CodingDudeGravatar extends HTMLElement {  get email() {    return this.hasAttribute('email');  }  constructor() {    super()    this.addEventListener('click', e => {        alert('You Clicked Me!')    });    this.innerText="Hello There!"  }  connectedCallback(){    if(this.email){        var email = this.attributes.email.value;       var gravatar = "http://www.gravatar.com/avatar"            this.innerHTML = "创建自定义标签以扩展 HTML 功能
    "+email } else { this.innerHTML = "No Email"; } } static get observedAttributes() { return ['email']; } attributeChangedCallback(name, oldValue, newValue) { if(name == 'email'){ alert(`The ${name} changed to ${newValue}`) } }}

    根据上面的代码,每次我们更改电子邮件时都会看到一条警报。

    创建自定义标签以扩展 HTML 功能

    自定义元素中的回调是同步的。如果在自定义元素上调用 el.setAttribute('email','newemail') ,浏览器将立即触发 attributeChangedCallback()

    disconnectedCallback

    生命周期方法列表中的最后一个是 disconnectedCallback。当您从文档中删除元素时,将调用此方法。当您想要清除自定义标签造成的影响时,该方法非常有用。您可以使用 el.remove() 方法轻松删除自定义标签。

    但是,您必须非常小心 disconnectedCallback() 的使用方式。如果用户选择关闭选项卡或浏览器,则永远不会触发此回调。

    7.属性到属性

    在任何基于 HTML 的应用程序中,开发人员使用反映在 DOM 上的属性是很常见的。例如, hidden 是可用于隐藏元素的属性,例如

    只会隐藏 DOM 中的元素。开发人员自然希望这些属性也适用于自定义标签。

    由于我们从 HTMLElement 扩展,因此默认情况下这些属性将出现在自定义元素中。然而,这些属性的行为是可以修改的。大多数时候,JavaScript 类中的 getter 和 setter 用于控制属性。

    codingdude-gravatar[hidden] {    opacity: 0.5;    pointer-events: none;}...inside the class{    get hidden() {        return this.hasAttribute('hidden');    }        set hidden(val) {        // Reflect the value of `hidden` as an attribute.        if (val) {        this.setAttribute('hidden', '');        } else {        this.removeAttribute('hidden');        }    }}

    演示

    本文中讨论的所有内容都可以在以下演示中进行实验。

    结论

    万岁!我们已经结束了关于如何创建自定义元素的文章。现在,您应该能够创建自定义元素并在 HTML 标记中使用它。一定要尝试一下!您将会惊讶地发现我们可以完成这么多工作。

    这只是自定义元素工作原理的开始。这个领域还有很多东西需要探索和学习。请继续关注此空间,了解有关自定义元素及其高级概念的更多帖子。

  • 以上就是创建自定义标签以扩展 HTML 功能的详细内容,更多请关注创想鸟其它相关文章!

    版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
    如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
    发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1551578.html

    (0)
    打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
    上一篇 2025年12月21日 21:53:01
    下一篇 2025年12月21日 21:53:22

    相关推荐

    • 如何使用正则表达式完整匹配HTML中Script标签的中间内容?

      完整匹配Script标签中间内容的正则表达式 正则表达式是用于从文本中查找特定模式的高级工具。对于HTML中Script标签中间内容的匹配,需要一个特定的正则表达式来实现完整的匹配。 匹配表达式 /(<scriptb([^”]+|”[^”]*”)*>)([sS]*?)()/g 立即学习“…

      2025年12月24日
      2300
    • CSS mask属性无法获取图片:为什么我的图片不见了?

      CSS mask属性无法获取图片 在使用CSS mask属性时,可能会遇到无法获取指定照片的情况。这个问题通常表现为: 网络面板中没有请求图片:尽管CSS代码中指定了图片地址,但网络面板中却找不到图片的请求记录。 问题原因: 此问题的可能原因是浏览器的兼容性问题。某些较旧版本的浏览器可能不支持CSS…

      2025年12月24日
      900
    • 如何用dom2img解决网页打印样式不显示的问题?

      用dom2img解决网页打印样式不显示的问题 想将网页以所见即打印的的效果呈现,需要采取一些措施,特别是在使用了bootstrap等大量采用外部css样式的框架时。 问题根源 在常规打印操作中,浏览器通常会忽略css样式等非必要的页面元素,导致打印出的结果与网页显示效果不一致。这是因为打印机制只识别…

      2025年12月24日
      800
    • 如何用 CSS 模拟不影响其他元素的链接移入效果?

      如何模拟 css 中链接的移入效果 在 css 中,模拟移入到指定链接的效果尤为复杂,因为链接的移入效果不影响其他元素。要实现这种效果,最简单的方法是利用放大,例如使用 scale 或 transform 元素的 scale 属性。下面提供两种方法: scale 属性: .goods-item:ho…

      2025年12月24日
      700
    • 如何调整Flexbox布局中项目对齐方式?

      正文: 调整弹性盒子(Flexbox)布局中项目的对齐方式有几个方法: 文本对齐问题 对于第一个问题,即文字不在 中的问题,这是因为设置了 height 属性。Flexbox 子元素的高度被拉伸到了 height 规定的大小,因此文字无法正常显示在内容内。解决方案是移除 height 属性,让子元素…

      2025年12月24日
      400
    • 如何利用BFC和inline-block解决兄弟元素间margin塌陷问题?

      BFC清除兄弟元素间margin塌陷原理 margin塌陷问题 当相邻的块级元素垂直排列,它们的margin可能会塌陷并重叠,称为margin塌陷。 BFC清除margin塌陷 清除margin塌陷的一种常见方法是将下方元素包裹在一个新的块级格式化上下文(BFC)中,因为BFC之间不会相互影响。 d…

      2025年12月24日
      500
    • Uniapp 中如何不拉伸不裁剪地展示图片?

      灵活展示图片:如何不拉伸不裁剪 在界面设计中,常常需要以原尺寸展示用户上传的图片。本文将介绍一种在 uniapp 框架中实现该功能的简单方法。 对于不同尺寸的图片,可以采用以下处理方式: 极端宽高比:撑满屏幕宽度或高度,再等比缩放居中。非极端宽高比:居中显示,若能撑满则撑满。 然而,如果需要不拉伸不…

      2025年12月24日
      400
    • PC端H5项目如何实现适配:流式布局、响应式设计和两套样式?

      PC端的适配方案及PC与H5兼顾的实现方案探讨 在开发H5项目时,常用的屏幕适配方案是postcss-pxtorem或postcss-px-to-viewport,通常基于iPhone 6标准作为设计稿。但对于PC端网项目,处理不同屏幕大小需要其他方案。 PC端屏幕适配方案 PC端屏幕适配一般采用流…

      2025年12月24日
      300
    • CSS 元素设置 10em 和 transition 后为何没有放大效果?

      CSS 元素设置 10em 和 transition 后为何无放大效果? 你尝试设置了一个 .box 类,其中包含字体大小为 10em 和过渡持续时间为 2 秒的文本。当你载入到页面时,它没有像 YouTube 视频中那样产生放大效果。 原因可能在于你将 CSS 直接写在页面中 在你的代码示例中,C…

      2025年12月24日
      400
    • 如何实现类似横向U型步骤条的组件?

      横向U型步骤条寻求替代品 希望找到类似横向U型步骤条的组件或 CSS 实现。 潜在解决方案 根据给出的参考图片,类似的组件有: 图片所示组件:图片提供了组件的外观,但没有提供具体的实现方式。参考链接:提供的链接指向了 SegmentFault 上的另一个问题,其中可能包含相关的讨论或解决方案建议。 …

      2025年12月24日
      800
    • 如何让小说网站控制台显示乱码,同时网页内容正常显示?

      如何在不影响用户界面的情况下实现控制台乱码? 当在小说网站上下载小说时,大家可能会遇到一个问题:网站上的文本在网页内正常显示,但是在控制台中却是乱码。如何实现此类操作,从而在不影响用户界面(UI)的情况下保持控制台乱码呢? 答案在于使用自定义字体。网站可以通过在服务器端配置自定义字体,并通过在客户端…

      2025年12月24日
      800
    • 如何优化CSS Grid布局中子元素排列和宽度问题?

      css grid布局中的优化问题 在使用css grid布局时可能会遇到以下问题: 问题1:无法控制box1中li的布局 box1设置了grid-template-columns: repeat(auto-fill, 20%),这意味着容器将自动填充尽可能多的20%宽度的列。当li数量大于5时,它们…

      2025年12月24日
      800
    • SASS 中的 Mixins

      mixin 是 css 预处理器提供的工具,虽然它们不是可以被理解的函数,但它们的主要用途是重用代码。 不止一次,我们需要创建多个类来执行相同的操作,但更改单个值,例如字体大小的多个类。 .fs-10 { font-size: 10px;}.fs-20 { font-size: 20px;}.fs-…

      2025年12月24日
      000
    • 绝对定位元素在不同分辨率下偏移,如何解决?

      盒子里的绝对定位元素偏移问题及解决方法 在自定义的输入框checkbox中,对于不同的分辨率设置的居中样式会发生意外的像素偏移,影响选中状态下小红点的居中效果。 偏移的原因在于使用像素单位px。不同分辨率下,像素点的显示方式不同,导致视觉上的错位。 解决方法是将像素单位替换为相对单位,如rem或em…

      2025年12月24日
      400
    • 如何在地图上轻松创建气泡信息框?

      地图上气泡信息框的巧妙生成 地图上气泡信息框是一种常用的交互功能,它简便易用,能够为用户提供额外信息。本文将探讨如何借助地图库的功能轻松创建这一功能。 利用地图库的原生功能 大多数地图库,如高德地图,都提供了现成的信息窗体和右键菜单功能。这些功能可以通过以下途径实现: 高德地图 JS API 参考文…

      2025年12月24日
      400
    • 如何使用地图库制作悬浮信息框和右键菜单?

      使用地图库制作悬浮信息框和右键菜单的地图显示 想要创建交互式的带有悬浮信息框和右键菜单的地图显示,使用地图库是一个便捷的方法。一般的地图库都提供对应的功能,让你轻松实现这些特性。 功能使用 以高德地图为例,在使用它的 JS API 1.4 时,可以通过以下方式添加信息窗体和右键菜单: 信息窗体:使用…

      2025年12月24日
      000
    • 如何使用 scroll-behavior 属性实现元素scrollLeft变化时的平滑动画?

      如何实现元素scrollleft变化时的平滑动画效果? 在许多网页应用中,滚动容器的水平滚动条(scrollleft)需要频繁使用。为了让滚动动作更加自然,你希望给scrollleft的变化添加动画效果。 解决方案:scroll-behavior 属性 要实现scrollleft变化时的平滑动画效果…

      2025年12月24日
      000
    • CSS mask 属性无法加载图片:浏览器问题还是代码错误?

      CSS mask 属性请求图片失败 在使用 CSS mask 属性时,您遇到了一个问题,即图片没有被请求获取。这可能是由于以下原因: 浏览器问题:某些浏览器可能在处理 mask 属性时存在 bug。尝试更新到浏览器的最新版本。代码示例中的其他信息:您提供的代码示例中还包含其他 HTML 和 CSS …

      2025年12月24日
      000
    • 如何为滚动元素添加平滑过渡,使滚动条滑动时更自然流畅?

      给滚动元素平滑过渡 如何在滚动条属性(scrollleft)发生改变时为元素添加平滑的过渡效果? 解决方案:scroll-behavior 属性 为滚动容器设置 scroll-behavior 属性可以实现平滑滚动。 html 代码: click the button to slide right!…

      2025年12月24日
      500
    • 如何解决用户代理样式表导致页面元素无法显示的问题?

      去除用户代理样式表的样式 在项目中遇到用户代理样式表的样式遮盖了页面元素,导致无法显示的情况,这可能是因为安装了去广告插件导致的。 通常,用户代理样式表是在浏览器中预定义的,用于提供默认的样式。然而,在特殊情况下,某些插件或扩展程序可能会注入自己的用户代理样式表,从而覆盖页面上的现有样式。 在这种情…

      2025年12月24日
      000

    发表回复

    登录后才能评论
    关注微信