下面给你一份通俗易懂 + 全面系统的《HTML5 中的 Microdata 与 History API（历史记录管理）详解》，包含用途、语法、示例与注意事项，可直接作为技术文档或教程使用。

HTML5 中 Microdata 与 历史记录管理 API（History API）详解

HTML5 引入了许多强大的新特性，其中 Microdata（微数据） 用于结构化数据标注，History API 用于前端无刷新改变 URL，是前端 SPA 框架的基础。本篇将系统讲解两者的核心概念与完整代码示例。

一、Microdata（微数据）详解

1. Microdata 是什么？

Microdata 是一种 HTML5 的结构化数据标注方式，它可以将网页内容标记为“可理解的信息”，让 搜索引擎、爬虫、AI 系统 更容易理解页面语义。

常见用途：

✔ SEO 搜索引擎优化
✔ 标注商品、评论、人物等信息
✔ Rich Snippets（谷歌结构化数据丰富摘要）
✔ JSON-LD 的前身（现在更推荐 JSON-LD）

2. Microdata 核心属性

属性说明
itemscope表示开始一个微数据项目（容器）。
itemtype指定数据类型（通常来自 schema.org）。
itemprop指定属性名称。
itemid唯一标识符（可选）。
itemref引用页面其他元素作为数据的一部分。

3. Microdata 示例（商品详情）

下面演示一个结构化商品信息示例（SEO 友好）：

<div itemscope itemtype="https://schema.org/Product">
  <h2 itemprop="name">iPhone 16 Pro Max</h2>
  <img itemprop="image" src="iphone16.jpg" alt="iPhone 16 Pro">

  <p itemprop="description">苹果最新旗舰机型，支持卫星通讯与A20芯片。</p>

  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer">
      <span>价格： ¥</span>
      <span itemprop="price">8999</span>
      <meta itemprop="priceCurrency" content="CNY">
  </div>

  <div itemprop="aggregateRating" itemscope itemtype="https://schema.org/AggregateRating">
      <span itemprop="ratingValue">4.8</span> 分（
      <span itemprop="reviewCount">3580</span> 条评价）
  </div>
</div>

4. itemref 示例（跨标签引用）

<div itemscope itemtype="https://schema.org/Person" itemref="extra">
  <span itemprop="name">张三</span>
</div>

<div id="extra">
  <span itemprop="jobTitle">软件工程师</span>
  <span itemprop="telephone">123456789</span>
</div>

这样张三的“职位”和“电话”就被整合进同一个数据对象里。

5. Microdata 的优缺点

优点：

  • 写法直观，与 HTML 结构绑定
  • 被搜索引擎支持（但近几年不如 JSON-LD）

缺点：

  • HTML 变得冗长，难以维护
  • 已被 W3C 移出标准核心，更推荐 JSON-LD

现在的推荐方式：
✔ 结构化数据：用 JSON-LD
✔ 老系统或 SEO 兼容：依然可用 Microdata

二、HTML5 历史记录管理 API（History API）

History API 让网页在 不刷新页面 的情况下修改浏览器历史记录，是 Vue/React/SPA 的核心技术。

1. API 列表

API说明
history.pushState(state, title, url)添加历史记录，不刷新页面
history.replaceState(state, title, url)替换当前历史记录
history.state获取当前状态对象
onpopstate监听浏览器前进/后退事件

2. pushState 示例（无刷新改变 URL）

<button onclick="goPage2()">切换到虚拟页面2</button>

<script>
function goPage2() {
    history.pushState({page: 2}, "page2", "/page2");
    document.body.innerHTML = "<h2>这是 Page 2（无刷新）</h2>";
}

// 监听浏览器返回
window.onpopstate = function(event) {
    alert("你点击了返回，state=" + JSON.stringify(event.state));
};
</script>

特点：

✔ URL 改变
✔ 页面不刷新
✔ 浏览器后退会触发 popstate

3. replaceState 示例

history.replaceState({page: 1}, "page1", "/page1");

不会新增历史记录，只是修改当前条目。

4. 监听 popstate（处理前进/后退）

window.addEventListener("popstate", function(event) {
    console.log("返回/前进触发了", event.state);
});

浏览器后退时会传回之前 pushState 填入的对象。

5. History API 使用注意点

✔ pushState 不会触发 popstate
✔ popstate 仅在用户 点击前进/后退按钮 时触发
✔ 修改 URL 必须与当前同源，否则报错
✔ 一般 URL 必须写相对路径，如 /product/123

三、Microdata + History API 实战整合示例

下面展示一个简单的 SPA 产品展示页面：

<button onclick="showPhone()">查看 iPhone</button>
<button onclick="showWatch()">查看 Apple Watch</button>

<div id="content"></div>

<script>
function showPhone() {
  history.pushState({product: "iphone"}, "iPhone", "/iphone");
  document.getElementById("content").innerHTML = `
    <div itemscope itemtype="https://schema.org/Product">
      <h2 itemprop="name">iPhone 16 Pro</h2>
      <span itemprop="price">8999</span>
    </div>
  `;
}

function showWatch() {
  history.pushState({product: "watch"}, "Apple Watch", "/watch");
  document.getElementById("content").innerHTML = `
    <div itemscope itemtype="https://schema.org/Product">
      <h2 itemprop="name">Apple Watch Ultra 3</h2>
      <span itemprop="price">6299</span>
    </div>
  `;
}

// 返回时根据 state 恢复页面
window.onpopstate = function(e) {
  if (!e.state) return;

  if (e.state.product === "iphone") showPhone();
  if (e.state.product === "watch") showWatch();
};
</script>

四、总结

技术作用
Microdata给 HTML 添加结构化数据（SEO、AI、爬虫可理解）
History API不刷新页面更新 URL，实现前端路由

两者配合能制作：

✔ SEO-friendly 页面
✔ 无刷新切换内容的 SPA
✔ 商品页切换、详情页路由