itemtype必须与itemscope共存于同一HTML元素,且值为严格大小写敏感的HTTPS完整URL;嵌套对象需显式声明子itemscope+itemtype;同类实体须各自独立声明作用域。

itemtype 必须和 itemscope 写在同一元素上
单独写 itemtype 没有任何效果,解析器会直接跳过。它不是“开关”,而是“契约”——必须和 itemscope 绑定在同一个 HTML 元素上,才算正式声明一个结构化数据作用域。
常见错误包括:
-
<p itemtype="https://schema.org/Product">iPhone</p>→ 缺itemscope,整块被忽略 -
<div itemscope><span itemtype="https://schema.org/Person">张三</span></div>→itemtype在子元素,父级没声明类型,无法识别 - 用 JS 动态给多个
<div>批量加itemscope和itemtype→ 搜索引擎不执行 JS,只读静态 HTML
正确写法:<div itemscope itemtype="https://schema.org/Product"><h1 itemprop="name">iPhone 15</h1></div>
itemtype 值必须是完整 HTTPS URL,大小写敏感
2026 年所有主流验证工具(Google Rich Results Test、Schema Markup Validator)对协议、域名、路径、大小写全部严格校验。错一个字符,整个作用域就失效。
立即学习“前端免费学习笔记(深入)”;
必须写成:https://schema.org/Product、https://schema.org/Organization、https://schema.org/RadioEpisode
以下全是无效写法:
使用 PptxGenJS 和 Python 解析,将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint(.pptx)演示文稿。
-
http://schema.org/Product(协议错误) -
https://schema.org/product(小写 p,schema.org 官方定义为大写首字母) -
https://schema.org/Product/(末尾斜杠) -
//schema.org/Product(协议省略) -
schema.org/Product(缺协议)
旧 vocab 如 http://data-vocabulary.org/Person 已全量弃用,2026 年不再支持。
嵌套结构必须显式声明子 itemscope + itemtype
当某个 itemprop 的值本身是一个对象(比如作者、地址、节目归属),不能靠“继承”或隔层包裹,必须紧贴该属性所在元素,同时声明 itemscope 和对应 itemtype。
例如标地址:
- ❌ 错误:
<div itemprop="address">北京市朝阳区建国路1号</div>→ 解析为纯文本,不识别为地址结构 - ✅ 正确:
<div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress"><span itemprop="streetAddress">建国路1号</span><span itemprop="addressLocality">朝阳区</span><span itemprop="addressCountry">CN</span></div>
再如标广播节目归属:isPartOf 必须绑定到一个独立的 <div itemscope itemtype="https://schema.org/RadioProgram">,不能只写 URL 字符串或塞进父级 scope 里。
同一页面多个同类实体,必须各自独立声明
不能用一个 itemscope 容器包住所有内容。每篇文章、每个商品、每期节目,都必须有自己专属的作用域起点。
比如三篇博客:
- ❌ 错误:一个
<section itemscope itemtype="https://schema.org/Article">里塞三篇全文 → 解析器当成一篇 Article,所有itemprop都归到同一个实例下 - ✅ 正确:每篇用独立容器,如三个
<article itemscope itemtype="https://schema.org/Article">
嵌套时也一样:一个 itemprop="review" 对应一个 Review 实体,就得有一个紧贴它的 itemscope itemtype="https://schema.org/Review",不能复用外层或跨区块共享。


















