如何使用 API 中的数据动态填充 HTML

PHP中文网 • 2025年3月7日 06:49:07 • 编程技术 • 阅读 2

作为web开发者（以及所有软件开发者），掌握应用程序编程接口（api）至关重要。简单来说，api是可通过javascript的fetch()方法访问的数据集合，这些数据并非本地存储，而是位于另一台服务器上，可在需要时访问全部或部分数据，并在网站或应用的特定部分显示。

本文将演示如何从一个包含哈利·波特角色信息的API获取数据，并在网页上显示。你会发现，数据获取和显示其实是项目中最简单的一部分。言归正传，让我们开始吧！

获取API数据

首先，将HTML文档中用于显示角色信息的容器（字符容器）分配给一个变量：

const charssection = document.getElementById('chars-container');

登录后复制

接下来，将API的URL分配给一个变量（简化代码），并创建一个异步函数（因为需要等待数据检索）：

// API URLconst charsurl = 'https://hp-api.herokuapp.com/api/characters';// 获取并过滤角色数据的异步函数async function getChars() {    const response = await fetch(charsurl);    const allCharsArr = await response.json();    let newCharsArr = [];    for (let i = 0; i  0 && allCharsArr[i].species === 'human') {            newCharsArr.push(allCharsArr[i]);        }    }    return newCharsArr;}

登录后复制

getChars()函数获取API数据，将其转换为JSON，然后将符合条件的数据对象（species属性为’human’且image属性长度大于0）推入newCharsArr数组。

立即学习“前端免费学习笔记（深入）”；

数据过滤的原因有很多，例如API的不完整性。通过循环和条件语句，可以根据项目需求处理不完整的数据。本例中，并非所有角色都包含图片，因此过滤掉缺少图片的数据。

getChars()函数返回一个包含过滤后角色数据的数组。

使用检索到的API数据填充页面

async function buildPage() {    const newCharsArr = await getChars();    // 填充角色卡片的HTML    for (let i = 0; i < newCharsArr.length; i++) {        charssection.innerHTML +=            ""            + ""            + "" // 心形图标，需引入字体图标库            + "@@##@@"            + "
"            + "" + newCharsArr[i].name + "
"            + "种族: " + newCharsArr[i].ancestry + "
"            + "学院: " + newCharsArr[i].house + "
"            + "演员: " + newCharsArr[i].actor + "
"            + "
";    }}

登录后复制

buildPage()函数使用getChars()函数返回的数据填充charssection变量。由于getChars()是异步的，buildPage()也必须是异步的，等待getChars()执行完毕后才能填充内容。

buildPage()函数遍历过滤后的数据数组，动态创建角色卡片，包含角色图片、姓名、种族、学院和演员信息。

下图是提取、过滤角色信息并填充页面后的页面截图（样式未包含在示例中，完整代码请参考项目链接）。