信息发布→ 登录 注册 退出

JavaScript实现API数据搜索与动态表格展示

发布时间:2025-11-08

点击量:

本教程旨在指导如何使用javascript从api获取数据,并在网页表格中动态展示。核心内容包括数据全局存储、利用`array.prototype.filter()`方法实现高效的数据搜索功能,并根据用户输入实时更新表格内容,同时强调代码结构优化和大小写不敏感的搜索实现。

在现代前端应用中,从API获取数据并以交互式表格的形式呈现是常见的需求。当数据量较大时,用户需要一个搜索功能来快速定位所需信息。本文将详细介绍如何利用JavaScript实现这一功能,包括数据获取、全局存储、动态表格渲染以及基于用户输入的实时搜索过滤。

1. 核心技术栈概述

实现这一功能主要依赖以下JavaScript核心技术:

  • Fetch API: 用于异步获取远程API数据。
  • DOM 操作: 用于动态创建、修改和更新网页元素,特别是表格行。
  • Array.prototype.filter(): 数组的高阶函数,用于根据指定条件筛选数组元素,是实现搜索功能的核心。
  • 事件监听器: 用于捕获用户在搜索框输入或点击搜索按钮时的行为。

2. HTML结构:搜索界面与数据表格

首先,我们需要构建基础的HTML骨架,包括一个输入框用于用户输入搜索关键词,一个搜索按钮来触发搜索,以及一个表格来展示数据。




    
    
    可搜索的API数据表格
    




    
    
    

    
    
国家 新增确诊 累计确诊 新增死亡 累计死亡 新增恢复 累计恢复 最后更新日期

注意: 确保输入框 (myInput)、搜索按钮 (mySubmit) 和表格主体 (tbody) 都具有唯一的 id 属性,以便JavaScript能够准确地获取并操作它们。

3. JavaScript实现:数据获取与全局存储

为了实现搜索功能,我们需要在首次从API获取数据后,将其存储在一个全局可访问的变量中。这样,每次用户进行搜索时,我们就不需要重新请求API,而是直接对已有的数据进行过滤。

// script.js

let countriesData = []; // 全局变量,用于存储从API获取的所有国家数据

/**
 * 从API获取数据并初始化全局变量
 */
const getdata = async () => {
    const endpoint = "https://api.covid19api.com/summary";
    try {
        const response = await fetch(endpoint);
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        const data = await response.json();
        // 将获取到的国家数据存储到全局变量
        countriesData = data.Countries;
        // 数据加载完成后,立即显示所有国家数据
        _DisplayCountries();
    } catch (error) {
        console.error("获取数据失败:", error);
        // 可以在这里添加错误提示给用户
    }
};

// 在页面加载完成后调用数据获取函数
getdata();

在上述代码中:

  • countriesData 被声明为一个全局数组,用于保存所有国家的数据对象。
  • getdata 是一个异步函数,负责使用 fetch API从指定端点获取数据。
  • 数据成功获取后,data.Countries 会被赋值给 countriesData。
  • _DisplayCountries() 函数在数据加载完成后立即调用,以显示所有国家的数据。

4. 数据展示与搜索逻辑

接下来,我们创建一个函数来负责数据的过滤和表格的渲染。这个函数将接受一个可选的搜索关键词作为参数。

// script.js (接上一段代码)

/**
 * 根据搜索关键词过滤并显示国家数据
 * @param {string} searchTerm - 用户输入的搜索关键词,默认为空字符串表示显示所有数据
 */
const _DisplayCountries = (searchTerm = "") => {
    const tbody = document.querySelector("#tbody");
    tbody.innerHTML = ``; // 清空现有表格内容

    // 使用filter方法根据搜索关键词筛选数据
    const filteredCountries = countriesData.filter(country =>
        country.Country.toLowerCase().includes(searchTerm.toLowerCase())
    );

    // 遍历筛选后的数据,并将其添加到表格中
    filteredCountries.forEach(result => {
        tbody.innerHTML += `
            ${result.Country}
            ${result.NewConfirmed}
            ${result.TotalConfirmed}
            ${result.NewDeaths}
            ${result.TotalDeaths}
            ${result.NewRecovered}
            ${result.TotalRecovered}
            ${result.Date}
        `;
    });

    // 如果没有搜索结果,可以显示提示信息
    if (filteredCountries.length === 0 && searchTerm !== "") {
        tbody.innerHTML = `没有找到匹配 "${searchTerm}" 的国家。`;
    }
};

_DisplayCountries 函数的实现细节:

  • 它接收一个 searchTerm 参数,默认为空字符串。当 searchTerm 为空时,将显示所有数据。
  • tbody.innerHTML = `` 清空了表格现有的所有行,确保每次渲染都是全新的结果。
  • countriesData.filter(...) 是核心搜索逻辑。它会遍历 countriesData 数组中的每个国家对象:
    • country.Country.toLowerCase() 将国家名称转换为小写。
    • searchTerm.toLowerCase() 将搜索关键词也转换为小写。
    • includes() 方法检查国家名称是否包含搜索关键词,从而实现大小写不敏感的模糊匹配。
  • forEach 循环用于遍历过滤后的 filteredCountries 数组,并为每个国家动态创建一行表格数据。
  • 添加了当没有搜索结果时的用户提示。

5. 事件监听与搜索触发

最后一步是为搜索按钮添加事件监听器,当用户点击按钮时,获取输入框中的值并调用 _DisplayCountries 函数来更新表格。

// script.js (接上一段代码)

// 为搜索按钮添加点击事件监听器
document.querySelector("#mySubmit").addEventListener("click", () => {
    const searchInput = document.querySelector("#myInput").value;
    _DisplayCountries(searchInput); // 将搜索框的值作为参数传递给显示函数
});

// 也可以为输入框添加 'keyup' 事件,实现实时搜索
document.querySelector("#myInput").addEventListener("keyup", (event) => {
    // 只有在用户按下Enter键时才搜索,或者实时搜索
    // if (event.key === "Enter") {
        const searchInput = document.querySelector("#myInput").value;
        _DisplayCountries(searchInput);
    // }
});
  • document.querySelector("#mySubmit").addEventListener("click", ...) 监听搜索按钮的点击事件。
  • 当点击发生时,它获取 myInput 输入框的当前值,并将其作为参数传递给 _DisplayCountries 函数。
  • 为了提供更好的用户体验,您还可以为输入框添加 keyup 事件监听器,实现用户输入时即时搜索的效果。

6. 完整代码示例

将上述HTML和JavaScript代码整合后,您将得到一个功能完整的可搜索数据表格。

HTML (index.html):




    
    
    可搜索的API数据表格
    




    
    

    
国家 新增确诊 累计确诊 新增死亡 累计死亡 新增恢复 累计恢复 最后更新日期

JavaScript (script.js):

let countriesData = [];

const getdata = async () => {
    const endpoint = "https://api.covid19api.com/summary";
    try {
        const response = await fetch(endpoint);
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        const data = await response.json();
        countriesData = data.Countries;
        _DisplayCountries(); // 初始显示所有数据
    } catch (error) {
        console.error("获取数据失败:", error);
        const tbody = document.querySelector("#tbody");
        tbody.innerHTML = `数据加载失败,请稍后再试。`;
    }
};

const _DisplayCountries = (searchTerm = "") => {
    const tbody = document.querySelector("#tbody");
    tbody.innerHTML = ``; // 清空现有表格内容

    const filteredCountries = countriesData.filter(country =>
        country.Country.toLowerCase().includes(searchTerm.toLowerCase())
    );

    if (filteredCountries.length === 0 && searchTerm !== "") {
        tbody.innerHTML = `没有找到匹配 "${searchTerm}" 的国家。`;
        return;
    }

    filteredCountries.forEach(result => {
        tbody.innerHTML += `
            ${result.Country}
            ${result.NewConfirmed}
            ${result.TotalConfirmed}
            ${result.NewDeaths}
            ${result.TotalDeaths}
            ${result.NewRecovered}
            ${result.TotalRecovered}
            ${result.Date}
        `;
    });
};

// 页面加载时获取数据
getdata();

// 搜索按钮点击事件
document.querySelector("#mySubmit").addEventListener("click", () => {
    const searchInput = document.querySelector("#myInput").value;
    _DisplayCountries(searchInput);
});

// 输入框实时搜索事件 (可选)
document.querySelector("#myInput").addEventListener("keyup", () => {
    const searchInput = document.querySelector("#myInput").value;
    _DisplayCountries(searchInput);
});

7. 进阶优化与注意事项

  • 大小写不敏感搜索的替代方案:正则表达式 除了使用 toLowerCase() 和 includes(),您还可以使用正则表达式来实现更灵活的搜索模式,例如:

    // 在 _DisplayCountries 函数内部
    const regex = new RegExp(searchTerm, "i"); // "i" 标志表示不区分大小写
    const filteredCountries = countriesData.filter(country =>
        country.Country.match(regex)
    );

    这种方法在需要更复杂的模式匹配时(例如匹配开头、结尾、或使用特定字符集)会更加强大。

  • 性能优化 对于非常庞大的数据集(例如数万甚至数十万条记录),每次 innerHTML 的重新赋值可能会导致性能问题。此时可以考虑:

    • 文档片段 (DocumentFragment): 批量构建DOM元素,然后一次性添加到文档中,减少重绘和回流。
    • 虚拟滚动 (Virtual Scrolling): 只渲染视口内可见的表格行,对于超大数据集非常有效。
    • 节流 (Throttling) / 防抖 (Debouncing): 如果使用 keyup 实时搜索,可以添加节流或防抖功能,避免用户输入过快导致频繁触发搜索,从而优化性能和用户体验。
  • 用户体验

    • 加载状态提示: 在数据从API加载时,显示一个“加载中...”的提示,避免页面空白。
    • 无结果提示: 当搜索没有匹配项时,清晰地告知用户。
    • 清除搜索: 添加一个清除按钮或在搜索框为空时自动显示所有数据。
  • 错误处理 在 getdata 函数中,我们已经添加了基本的 try...catch 块来捕获API请求错误。在实际应用中,您可能需要更详细的错误信息展示给用户。

  • 代码分离与模块化 对于更复杂的应用,可以将数据获取、渲染逻辑和事件处理进一步封装到不同的模块或类中,提高代码的可维护性和复用性。

总结

通过本教程,我们学习了如何利用JavaScript的Fetch API获取远程数据,并将其存储在全局变量中。核心搜索功能通过 Array.prototype.filter() 结合 toLowerCase() 和 includes() 方法实现,确保了大小写不敏感的模糊匹配。同时,通过动态更新DOM,实现了用户输入后表格内容的实时刷新。遵循代码分离的原则,将数据获取和数据展示逻辑封装在不同的函数中,有助于提升代码的可读性和可维护性。这些技术是构建交互式前端数据展示应用的基础。

标签:# javascript  # java  # html  # js  # 前端  # json  # 正则表达式  # 大数据  #   # ai  # 数据搜索  # 点击事件  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!