itemtype必须使用Schema.org官方定义的完整HTTPS URL,如https://schema.org/Person;禁止HTTP、缺协议、带fragment、末尾斜杠、版本号或自定义后缀;嵌套时各层级需独立声明完整URL;避免微数据与JSON-LD混用同一实体。

itemtype 必须用 Schema.org 官方定义的完整 URL
itemtype 的值不是随便写的字符串,也不是缩写或别名,必须是 Schema.org 上某个类型(如 Person、Article)对应的标准 URI。浏览器和结构化数据工具(如 Google Rich Results Test)只认这个确切地址。
常见错误是填成:http://schema.org/Person(HTTP 协议)、schema.org/Person(缺协议)、https://schema.org#Person(用了 fragment,无效)——这些都不被识别。
- ✅ 正确写法:
https://schema.org/Person - ✅ 正确写法:
https://schema.org/Recipe - ❌ 错误写法:
http://schema.org/Person(Google 已明确要求 HTTPS) - ❌ 错误写法:
https://schema.org/Person/(末尾斜杠会 404,URL 不匹配)
嵌套 itemtype 时,每个层级都要独立写完整 URL
HTML 中允许嵌套 itemscope,但每个 itemtype 都得单独指定完整地址,不能“继承”或省略。比如一个 Person 里嵌套 Organization,就得分别写两个 itemtype 属性。
<div itemscope itemtype="https://schema.org/Person">
<span itemprop="name">张三</span>
<div itemprop="worksFor" itemscope itemtype="https://schema.org/Organization">
<span itemprop="name">某某科技</span>
</div>
</div>
注意:itemprop="worksFor" 是属性映射关系,不改变 itemtype;子元素的 itemtype 仍需显式声明为 https://schema.org/Organization,不能靠父级推断。
不要用微数据 + JSON-LD 混合定义同一实体
如果页面已用 <script type="application/ld+json"></script> 声明了 Article,就别再在 HTML 标签里用 itemtype="https://schema.org/Article" 重复标记同一内容。两者语义冲突或字段不一致时,搜索引擎可能忽略微数据,甚至报错 Conflicting types。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 优先选 JSON-LD:更灵活、不污染 HTML 结构、支持复杂嵌套
- 微数据适合简单场景(如评论、面包屑),且必须确保
itemtype和 JSON-LD 中的@type完全一致(大小写、拼写、协议、路径) - 验证工具(如 Rich Results Test)会把不同来源的同名实体当冲突处理,尤其
url或sameAs不一致时
Schema.org 类型 URL 不支持版本号或自定义后缀
有人试图加版本(如 https://schema.org/Person/v2)或本地命名空间(如 https://example.com/schema/Person),这会让所有结构化数据解析器直接失效。Schema.org 的设计就是扁平、无版本、全局唯一。
如果你需要扩展字段(比如加个内部工号 employeeId),只能:
- 用
additionalProperty包装(标准方式) - 或在 JSON-LD 中用自定义命名空间(但要配
@context,且微数据不支持) -
itemtype本身绝不能改,必须严格保持为https://schema.org/XXX
最常被忽略的一点:即使你只改了一个字母(比如 https://schema.org/Artical),整个 itemtype 就变成无效类型,所有 itemprop 都失去上下文,等同于没标。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










