如何使用HTML itemtype属性实现微数据标记-html教程-PHP中文网

itemtype 必须与 itemscope 配合使用才能生效，单独设置无效；需指定有效 schema.org 类型 uri，且嵌套实体须各自带 itemscope。

如何使用html itemtype属性实现微数据标记

itemtype 本身不能单独实现微数据标记，必须配合 itemscope、itemprop 和有效 Schema.org 类型 URI 才能被解析器识别。只加 itemtype 是无效的。

itemtype 必须搭配 itemscope 才生效

itemtype 的作用是指定当前微数据块所描述的实体类型（如 "https://schema.org/Person"），但它只是“声明类型”，不开启微数据解析上下文。浏览器和搜索引擎爬虫只在遇到带有 itemscope 的元素时，才开始收集其内部的 itemprop 属性。

✅ 正确写法：

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

❌ 无效写法：

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

—— 缺少 itemscope，整个块不会被当作微数据处理

⚠️ 注意：URI 必须完整且可访问（推荐用 https://schema.org/ 开头），http://schema.org/ 虽旧但仍被支持；但拼错、少斜杠（如 https://schema.org/Person/）或用自定义非标准地址会导致解析失败

itemprop 值必须严格匹配 itemtype 定义的属性

Schema.org 类型定义了哪些属性是合法的。例如 https://schema.org/Person 允许 name、jobTitle、telephone，但不允许 nickname 或 age（除非用 additionalProperty 显式扩展）。

Article To Html

文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。

下载

✅ 合法：<span itemprop="jobTitle">前端工程师</span>
❌ 非法（Google Structured Data Testing Tool 会报错）：<span itemprop="yearsOfExperience">5</span> —— 该属性不在 Person 官方定义中
? 提示：查属性是否合法，直接打开 https://schema.org/Person 页面，看 “Properties” 列表；不要依赖记忆或第三方文档
⚠️ 布尔值或枚举值需按规范写（如 gender 接受 "Male"/"Female" 字符串，不是 true 或数字 1）

嵌套 itemtype 需用独立 itemscope 包裹

当一个实体包含另一个实体（如 Person 有 Organization 类型的 alumniOf），不能把子类型直接写在父元素上，必须新建带 itemscope 和对应 itemtype 的容器。

✅ 正确嵌套：

<div itemscope itemtype="https://schema.org/Person">
  <span itemprop="name">李四</span>
  <div itemprop="alumniOf" itemscope itemtype="https://schema.org/Organization">
    <span itemprop="name">清华大学</span>
  </div>
</div>

❌ 错误写法：

<div itemscope itemtype="https://schema.org/Person">
  <span itemprop="name">李四</span>
  <div itemprop="alumniOf" itemtype="https://schema.org/Organization">
    <span itemprop="name">清华大学</span>
  </div>
</div>

—— 子 div 缺 itemscope，itemtype 被忽略，name 会被错误归属到外层 Person

? 小技巧：嵌套层级深时，用缩进保持可读性；避免用 <span></span> 包多行内容，改用 <div> 或 <code><section></section> 更稳妥
最常被忽略的是 itemscope 的强制性——它不是可选修饰，而是微数据解析的开关。哪怕 itemtype 写得再准，漏掉这个布尔属性，所有 itemprop 都只是普通 HTML 属性，不会出现在结构化数据报告里。