实战案例

AJAX 教程 · 第 8 章 · 8 次浏览

用 fetch 做一个完整功能:新闻列表 + 搜索 + 加载状态。这个案例覆盖了 AJAX 的全部要点。

功能拆解

  • 页面加载时请求列表,显示 loading
  • 搜索框输入,防抖后请求接口
  • 渲染结果,处理空数据和错误

代码示例

<div id="app">
    <input id="kw" placeholder="搜索新闻…">
    <p id="status"></p>
    <ul id="list"></ul>
</div>

<script>
const kw = document.getElementById("kw");
const list = document.getElementById("list");
const status = document.getElementById("status");

async function search(keyword = "") {
    status.textContent = "加载中…";
    list.innerHTML = "";
    try {
        const res = await fetch("/api/news?kw=" + encodeURIComponent(keyword));
        if (!res.ok) throw new Error("接口错误");
        const data = await res.json();
        status.textContent = "";
        if (!data.length) {
            status.textContent = "没有找到相关新闻";
            return;
        }
        list.innerHTML = data.map(n =>
            `<li><a href="${n.url}" target="_blank">${n.title}</a></li>`
        ).join("");
    } catch (err) {
        status.textContent = "加载失败:" + err.message;
    }
}

// 防抖:停止输入 300ms 后再请求
let timer;
kw.addEventListener("input", () => {
    clearTimeout(timer);
    timer = setTimeout(() => search(kw.value), 300);
});

search();   // 首次加载
</script>
📚 HTML 标签速查
常用条目速查,完整版见对应教程章节。可复制代码到在线运行中测试。
写法 / 语法作用
&lt;h1&gt;-&lt;h6&gt;标题,h1 最高,每页只用一个 h1
&lt;p&gt;段落,自动加前后间距
&lt;a href=""&gt;链接,href 是目标地址
&lt;img src="" alt=""&gt;图片,src 地址,alt 替代文字
&lt;ul&gt; / &lt;li&gt;无序列表
&lt;ol&gt; / &lt;li&gt;有序列表,数字编号
&lt;dl&gt; / &lt;dt&gt; / &lt;dd&gt;自定义列表:术语 + 说明
&lt;table&gt; / &lt;tr&gt; / &lt;td&gt; / &lt;th&gt;表格:行 / 单元格 / 表头
&lt;form action="" method=""&gt;表单,action 提交地址,method 提交方式
&lt;input type=""&gt;输入控件,type 有 text/password/email/number 等
&lt;textarea&gt;多行文本输入
&lt;select&gt; / &lt;option&gt;下拉框及选项
&lt;button type="submit"&gt;按钮,submit 提交表单
&lt;strong&gt; / &lt;em&gt;加粗(重要)/ 斜体(强调)
&lt;div&gt; / &lt;span&gt;区块容器 / 行内容器
&lt;header&gt; &lt;nav&gt; &lt;main&gt;语义化:页眉 / 导航 / 主体
&lt;section&gt; &lt;article&gt; &lt;aside&gt;语义化:分节 / 独立内容 / 侧栏
&lt;footer&gt;页脚:版权、备案
&lt;video&gt; / &lt;audio&gt;HTML5 视频 / 音频,加 controls 显示控制条
&lt;iframe src=""&gt;嵌入其他网页
&lt;!-- 注释 --&gt;HTML 注释,不显示在页面
&lt;br&gt; / &lt;hr&gt;换行 / 水平分割线
&lt;pre&gt;保留空格和换行,原样显示
&lt;blockquote&gt; / &lt;q&gt;块级引用 / 行内引用
&lt;figure&gt; / &lt;figcaption&gt;图文组合及说明