如何使用HTML itemtype属性标记结构化数据-html教程-PHP中文网

itemtype单独使用无效，必须与itemscope成对出现且配合itemprop才能触发结构化数据解析；其值必须是https://schema.org/下的完整https url（如https://schema.org/person），缩写、http协议、尾部斜杠或本地路径均导致搜索引擎静默丢弃。

如何使用html itemtype属性标记结构化数据

itemtype 本身不触发结构化数据解析，单独用它毫无作用——Google、Bing 等搜索引擎只认 itemscope + itemtype + itemprop 三者配合的完整微数据（Microdata）语法，且 itemtype 必须是合法 URL（通常是 schema.org 的类型地址）。

为什么 `itemtype` 单独写没用

浏览器和搜索引擎不会扫描孤立的 itemtype 属性。它必须嵌套在带有 itemscope 的元素内，否则被完全忽略。

<div itemtype="https://schema.org/Person"></div> → 无效：缺少 itemscope
<div itemscope itemtype="https://schema.org/Person"></div> → 有效起点，但还需 itemprop 标记具体字段
常见错误：把 itemtype 写成缩写如 "Person" 或本地路径 "./schema.json" → 必须是完整 HTTPS URL

正确写法：从 `itemscope` 开始套三层

结构化数据不是“加个属性就完事”，而是用 HTML 元素包裹语义层级。以标记一篇博客文章为例：

Article To Html

文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。

下载

<article itemscope itemtype="https://schema.org/BlogPosting"><h1 itemprop="headline">标题文本</h1>
  <time itemprop="datePublished" datetime="2024-05-20">2024年5月20日</time><div itemprop="author" itemscope itemtype="https://schema.org/Person">
    <span itemprop="name">张三</span>
  </div>
</article>

itemscope 声明一个新实体作用域
itemtype 指定该实体属于哪个 schema 类型（必须是 schema.org 的完整 URL）
itemprop 在该作用域内标记具体属性，值取自元素文本、datetime、href 等可提取属性
嵌套结构合法：一个 BlogPosting 里可以有 author（指向另一个 Person 实体）

容易踩的坑：URL 失效、类型错配、属性不在范围内

即使语法对了，结构化数据仍可能被搜索引擎拒绝，常见原因：

itemtype 用了 HTTP 而非 HTTPS → 必须是 https://schema.org/xxx，HTTP 会直接失效
用了已废弃类型，比如 https://schema.org/Article 虽然存在，但对博客更推荐 BlogPosting（语义更准，富媒体结果支持更好）
itemprop="image" 指向一个没有 src 的 <img>，或写在 <p></p> 里 → 图片必须是 <img itemprop="image" src="..."> 或 <link itemprop="image" href="...">
属性值为空或仅空格 → <span itemprop="name"> </span> 不会被识别为有效 name