HTML itemtype属性怎么设置复合嵌套结构-html教程-PHP中文网

itemtype必须是完整https url，如https://schema.org/person，禁用person、https://schema.org/person/、http://schema.org/person等写法；嵌套结构中每层均需独立声明itemscope与itemtype，且itemprop须紧邻对应itemscope元素。

html itemtype属性怎么设置复合嵌套结构

itemtype 必须是完整 HTTPS URL，不能拼接或截断

itemtype 值不是字符串占位符，而是机器可验证的类型标识。写成 Person、https://schema.org/Person/（末尾斜杠）、http://schema.org/Person 或 //schema.org/Person 全部无效。

浏览器和 Google Rich Results Test 会直接忽略整块 microdata。正确写法只有一种：https://schema.org/Person —— 协议、域名、路径全小写、无斜杠、无空格。

多个嵌套层级，每一层都必须独立声明自己的 itemtype，不能复用外层值
LocalBusiness 下的 address 字段必须是 https://schema.org/PostalAddress，不是 https://schema.org/Address（后者不存在）
Offer 的 priceCurrency 是字符串，但 priceSpecification 是另一个对象，需另起 itemscope itemtype="https://schema.org/UnitPriceSpecification"

嵌套结构里 itemprop 和 itemscope 必须紧邻，中间不能插 wrapper

这是最常被忽略的硬性规则：如果某个 itemprop 的值本身是一个结构化对象（比如作者、地址、评论），那么该对象的 itemscope 必须直接写在同一个 HTML 元素上，不能隔一层 <div> 或 <code><span></span>。

错误示例：<p itemprop="author"></p> <div itemscope itemtype="https://schema.org/Person">张三</div>

—— itemprop="author" 没绑定到任何 itemscope，Google 解析时直接丢弃整个 author 节点。

正确写法只有这一种：<p itemprop="author" itemscope itemtype="https://schema.org/Person">张三</p>。

嵌套越深，越容易漏掉某一层的 itemscope itemtype，建议每加一层就跑一次 Google Rich Results Test
<meta itemprop="name" content="iPhone"> 这类隐藏字段可以脱离可见内容，但依然要确保其父元素有 itemscope
地址类嵌套常漏掉 postalCode 或 addressCountry，导致 LocalBusiness 标记不完整，地图功能失效

同一 itemscope 内多次使用相同 itemprop 会被自动转为数组

比如一篇文章有多个作者，不需要手动构造 JSON 数组，只需重复写 itemprop="author" 并各自包裹 itemscope itemtype：

anything-to-html

将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。

下载

<div itemscope itemtype="https://schema.org/Article">
  <h1 itemprop="headline">标题</h1>
  <div itemprop="author" itemscope itemtype="https://schema.org/Person">张三</div>
  <div itemprop="author" itemscope itemtype="https://schema.org/Person">李四</div>
</div>

Google 会把这两个 author 合并为一个数组，而不是覆盖或报错。

这种写法只适用于 schema.org 明确允许多值的属性（如 review、author、sameAs）
价格、日期等单值字段（如 price、datePublished）重复写会导致解析失败或取最后一个值
不要试图用 itemprop="author" content="张三,李四" 来“简化”，microdata 不支持逗号分隔的字符串数组

itemprop 提取的是 textContent，不是 innerHTML

itemprop 绑定的是元素的纯文本内容，所有 HTML 标签、实体、换行都会被保留。比如：<p itemprop="name">iPhone <sup>®</sup></p>，实际提取值是 "iPhone ®"，Google 可能拒收。

需要干净值时，优先用 <meta> 替代：

<meta itemprop="name" content="iPhone 15">
<time itemprop="datePublished" datetime="2026-07-03">2026年7月3日</time> —— datetime 属性才是机器读取的值，显示文本可任意
<meta itemprop="price" content="299.00"> —— 避免 ¥ 符号、逗号、空格混入

复合嵌套最难的不是写法，而是每一层都得对齐 schema.org 官方定义：类型名、属性名、值类型、嵌套关系，缺一不可。漏掉一个 itemscope，或写错一个 URL 斜杠，整块数据就归零。