itemtype必须与itemscope同元素,且为完整HTTPS URL;itemprop值须属对应schema类型允许属性;嵌套需紧贴绑定;提取仅认textContent;验证必用Google工具。

itemtype 必须和 itemscope 写在同一元素上,否则 itemprop 无效
单独加 itemprop 或只写 itemscope 而不配 itemtype,整个微数据块会被搜索引擎直接忽略。Google Rich Results Test 会报“Missing required field 'itemtype'”或干脆不显示任何结构化数据。
-
itemscope和itemtype必须出现在同一个 HTML 元素上,比如<div itemscope itemtype="https://schema.org/Product"> -
itemtype值必须是完整 HTTPS URL,结尾不能带斜杠:https://schema.org/Product✅,https://schema.org/Product/❌ - 不能用缩写、本地路径或 HTTP 协议:
Product、./product、http://schema.org/Product全部失效 - 2026 年起,
http://data-vocabulary.org/Person等旧地址已完全不被支持
itemprop 的合法性取决于 itemtype 定义的 schema 类型
itemprop 不是通用标签,它只能在当前 itemtype 所属类型允许的属性列表中取值。超出范围就会报错,比如在 Person 里用 price,工具会提示“Property price is not a valid property of Person”。
- 查 schema.org 对应类型的 Properties 表格,例如
https://schema.org/Product明确列出name、image、offers等可用属性 -
telephone只对Person和Organization合法;datePublished只属于Article、BlogPosting等内容类型 - 同一
itemprop名可在同一itemscope内多次出现(如多个review),自动转为数组 - 嵌套对象(如
author)必须同时满足:父级itemprop+ 子级itemscope itemtype写在同一元素上
itemprop 值提取规则和常见踩坑点
搜索引擎提取 itemprop 值时,只读取元素的 textContent,不是 innerHTML。任何子标签、HTML 实体、不可见 Unicode 字符都会原样进入结构化数据值,导致价格、日期等字段解析失败。
使用 PptxGenJS 和 Python 解析,将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint(.pptx)演示文稿。
- 错误写法:
<p itemprop="price">¥ 89.00</p>→ 提取值含不间断空格(U+00A0),Google 拒绝识别 - 正确做法:用普通空格,并统一清洗文本:
textContent.replace(/\s+/g, ' ').trim() - 想隐藏值(如 SKU、内部 ID),必须用
<meta itemprop="sku" content="A2890">,且content属性不可省略 -
<img itemprop="image" src="...">不生效——itemprop="image"要求值是 URL 字符串,得改用<link itemprop="image" href="...">或<meta itemprop="image" content="...">
嵌套结构里 itemprop 和 itemscope 的绑定关系必须紧贴
当某个 itemprop 的值本身是一个实体(比如 author 是 Person),它的 itemscope 必须作为该 itemprop 的直接载体,不能隔层。否则 Google 会丢弃整个嵌套块,且不报明确错误,只让结构化数据“静默失效”。
立即学习“前端免费学习笔记(深入)”;
- ✅ 正确:
<div itemprop="author" itemscope itemtype="https://schema.org/Person">张三</div> - ❌ 错误:
<div itemprop="author"><div itemscope itemtype="https://schema.org/Person">张三</div></div>——itemprop="author"没绑定到任何itemscope - LocalBusiness 的
address嵌套中漏掉postalCode或addressCountry,会导致地图功能无法触发 -
itemref在 2026 年仍基本无实际效用,主流搜索引擎不支持跨区域拼接,别依赖它


















