0

0

使用 querySelector 无法获取动态创建的元素?原因与解决方案

花韻仙語

花韻仙語

发布时间:2025-09-20 20:26:01

|

200人浏览过

|

来源于php中文网

原创

使用 queryselector 无法获取动态创建的元素?原因与解决方案

问题背景

正如摘要所述,在使用 JavaScript 操作 DOM 时,经常会遇到动态创建元素后无法立即获取的问题。 典型场景是,通过 fetch 请求获取数据,然后使用 insertAdjacentHTML 将数据渲染到页面上。 然而,如果尝试在数据渲染完成之前使用 querySelector 获取这些新创建的元素,往往会失败。

原因分析

问题的核心在于 JavaScript 的执行机制。insertAdjacentHTML 方法将 HTML 字符串插入到 DOM 中,这是一个异步过程。这意味着,即使代码紧随其后使用 querySelector 尝试获取新插入的元素,这些元素可能尚未完全渲染到页面上。因此,querySelector 无法找到这些元素,返回 null 或空集合。

解决方案

针对上述问题,我们提供以下两种解决方案:

1. 利用 Promise 链式调用:

如果使用 fetch 方法获取数据,可以利用 Promise 的链式调用特性,确保在数据渲染完成后再执行获取元素的操作。

首先,修改 fill 函数,使其返回一个 Promise 对象:

export const fill = function (brand) {
  return fetch(`./data/${brand}.json`)
    .then(function (response) {
      return response.json();
    })
    .then(function (data) {
      let products = [...data.products];

      products.forEach(product => {
        row.insertAdjacentHTML(
          'afterbegin',
          ` <a class="catalog__link" href="#" >
              <div class="catalog__product">
              <div class="catalog__product-img">
              <img class="catalog__productImg" src=${product['img-src']} alt="" srcset="" />
              </div>
              <h3 class="catalog__product-model">${product['model']}</h3>
              <p class="catalog__product-brand">${product['brand']}</p>
              <span class="catalog__product-price">${product['price']}</span>
          </div></a>`
        );
      });
    });
};

然后,在 loadContent.js 文件中,使用 .then() 方法链式调用 productSave 函数:

import { fill } from './fillCatalog.js';
import { productSave } from './productSave.js';

fill('jordans').then(productSave);

这样,productSave 函数只有在 fill 函数中的 fetch 请求成功完成,并且数据渲染到页面上之后才会执行,从而确保 querySelector 能够找到新创建的元素。

Rose.ai
Rose.ai

一个云数据平台,帮助用户发现、可视化数据

下载

2. 使用轮询检测机制:

如果无法修改 fill 函数,或者不确定元素何时渲染完成,可以使用轮询检测机制。该机制通过定时器定期检查目标元素是否存在,一旦找到目标元素,就执行相应的操作。

以下是一个示例代码:

function waitForElement(selector) {
  return new Promise((resolve, reject) => {
    const timeout = setTimeout(() => {
      clearInterval(interval);
      reject(`Element "${selector}" not found within 10 seconds.`);
    }, 10000); // 设置超时时间为 10 秒

    const interval = setInterval(() => {
      const element = document.querySelectorAll(selector);
      if (element.length > 0) {
        clearInterval(interval);
        clearTimeout(timeout);
        resolve(element);
      }
    }, 200); // 每 200 毫秒检查一次
  });
}

export const productSave = function () {
  waitForElement('.catalog__link')
    .then(links => {
      links.forEach(link => {
        link.addEventListener('click', e => {
          let productItem = link.querySelector('.catalog__product');
          const newProduct = new Product(
            productItem.querySelector('.catalog__productImg').src,
            productItem.querySelector('.catalog__product-model').textContent,
            productItem.querySelector('.catalog__product-brand').textContent,
            productItem.querySelector('.catalog__product-price').textContent.replace(/\D/g, '')
          );
          localStorage.setItem('newCard', JSON.stringify(newProduct));
        });
      });
    })
    .catch(error => {
      console.error(error); // 处理超时或元素未找到的情况
    });
};

在这个示例中,waitForElement 函数接受一个 CSS 选择器作为参数,并返回一个 Promise 对象。该 Promise 对象会在找到目标元素时 resolve,或者在超时后 reject。

在 productSave 函数中,我们使用 waitForElement 函数来等待 .catalog__link 元素出现。一旦找到这些元素,就执行相应的操作。

注意事项

  • 超时时间: 在使用轮询检测机制时,务必设置合理的超时时间,以避免无限循环。
  • 性能影响: 轮询检测机制会消耗一定的 CPU 资源,因此应该尽量避免过度使用。
  • 事件委托: 对于动态创建的元素,可以考虑使用事件委托,将事件监听器绑定到父元素上,从而避免频繁地添加和移除事件监听器。

总结

动态创建元素后无法立即获取是 JavaScript 开发中常见的问题。通过理解问题的根本原因,并选择合适的解决方案,可以有效地解决这个问题。 本文提供的两种解决方案,Promise 链式调用和轮询检测机制,各有优缺点,可以根据实际情况选择使用。 同时,需要注意超时时间、性能影响和事件委托等问题,以确保代码的稳定性和效率。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

254

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1089

2024.03.01

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

760

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1567

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

650

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

1228

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

1204

2024.04.29

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

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

精品课程

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

共14课时 | 0.9万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

CSS教程
CSS教程

共754课时 | 42.8万人学习

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

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