itemscope与itemtype必须共存于同一html标签,缺一不可;itemtype须为有效https url且末尾无斜杠,如https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937product;itemprop仅在itemscope作用域内生效,嵌套对象需紧贴itemprop声明itemscope。

itemscope 和 itemtype 必须写在同一标签里
单独加 itemscope 或只写 itemtype 都无效,Google Rich Results Test 会直接跳过整块。这两个属性是作用域声明的“绑定对”,缺一不可,且必须出现在同一个 HTML 元素上。
-
itemscope不是开关,它本身不携带语义,只是告诉解析器“这里开始一个新实体” -
itemtype必须是完整 HTTPS URL,比如https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Product,不能是Product、//schema.org/Product或http://schema.org/Product - 末尾不能带斜杠:
https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Product/❌,https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Product✅ - 旧地址如
http://data-vocabulary.org/Product已被 Google 完全停用(2026 年起),写就等于没写
itemtype 值必须指向可验证的 schema.org 类型
itemtype 不是随便填的字符串,它必须对应 schema.org 上真实存在的类型,且该 URL 在 HTTP 层能返回 200 状态码(哪怕页面是 HTML 文档)。
使用 PptxGenJS 和 Python 解析,将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint(.pptx)演示文稿。
- 查类型要上 https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937 搜,比如想标“餐厅”,得选
https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Restaurant,不是https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937LocalBusiness(除非你确认主体确实是泛指本地商家) - 同一页面多个同类实体(如三篇博客),每个都要独立的
itemscope+itemtype容器,不能复用外层一个 - 页面主类型由用户打开时最想了解的内容决定:企业官网首页用
Organization,产品页用Product,文章页用Article
itemprop 只在有 itemscope 的上下文中才有效
itemprop 不是全局标签,它必须被某个带 itemscope 的祖先元素包裹,否则解析器找不到归属,直接丢弃。
- 错误写法:
<p itemprop="name">iPhone 15</p>—— 外层没itemscope,整个itemprop被忽略 - 正确结构:
<div itemscope itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Product"><h1 itemprop="name">iPhone 15</h1></div> -
itemprop提取的是元素的textContent,不是 HTML;含<sup></sup>、®等会导致值含符号,价格/名称类字段易被拒收 - 纯文本不安全的字段(如价格、日期、电话),必须用专用写法:
<meta itemprop="price" content="5999.00">、<time itemprop="datePublished" datetime="2026-10-01"></time>
嵌套对象必须紧贴 itemprop 写 itemscope
当某个 itemprop 对应的是另一个实体(比如作者、地址、评论者),它的 itemscope 必须作为该 itemprop 所在元素的直接子元素,不能隔层。
- ✅ 正确:
<div itemprop="author" itemscope itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person">张三</div> - ❌ 错误:
<div itemprop="author"><div itemscope itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Person">张三</div></div>——itemprop="author"没绑定到任何itemscope,整个嵌套块被丢弃 - 地址类嵌套常漏掉
postalCode或addressCountry,导致LocalBusiness标记不完整,地图功能失效 - 每嵌套一层,建议立刻用 Google Rich Results Test 验证一次,越深越容易漏掉某层的
itemscope和itemtype
itemscope + itemtype,Search Console 就会静默丢失这部分结构化数据。前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










