HTML itemtype属性与itemprop配置实例-html教程-PHP中文网

itemtype 必须为完整 HTTPS URL，如 https://schema.org/Product；itemprop 值须严格匹配 schema.org 官方字段名且区分大小写；嵌套需 itemscope 与 itemprop 同元素绑定；数值、日期、URL 等需用 content 或 datetime 显式声明。

html itemtype属性与itemprop配置实例

itemtype 必须是完整 HTTPS URL，不能缩写或省略协议

Google 和主流结构化数据测试工具（如 Rich Results Test）在 2026 年已完全弃用 http:// 和旧 vocab（如 http://data-vocabulary.org/Person），只认 https://schema.org/ 开头的绝对 URL。写错一个字符、少一个斜杠、大小写不匹配，整个 itemscope 块都会被静默丢弃。

常见错误包括：itemtype="Product"、itemtype="https://schema.org/product"、itemtype="https://schema.org/Product/"（末尾斜杠非法）、itemtype="//schema.org/Person"。

✅ 正确写法：itemtype="https://schema.org/Product"、itemtype="https://schema.org/LocalBusiness"
❌ 错误写法：itemtype="Product"、itemtype="https://schema.org/product"、itemtype="https://schema.org/Product/"
验证方式：把页面 URL 粘贴到 Google Rich Results Test，看是否报 Missing field 'itemtype' 或 Invalid itemtype value

itemprop 值必须严格匹配 schema.org 对应 type 的 Properties 列表

itemprop 不是通用标签，它绑定的是某个特定 itemtype 下官方定义的字段。比如 telephone 在 https://schema.org/Person 和 https://schema.org/Organization 中合法，但在 https://schema.org/Event 中根本不存在——加了也会被忽略。

更隐蔽的问题是大小写和拼写：写成 itemprop="telephonenumber" 或 itemprop="Telephone" 都无效，必须是小写的 telephone。

Wechat Article Html

将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。

下载

查法：打开 https://schema.org/ → 搜索目标类型（如 Product）→ 点进详情页 → 拉到 “Properties” 表格里找可用字段
多值字段（如 review、author）要拆成多个独立元素，不能用逗号分隔文本
price、ratingValue 等数值类属性，必须用 content 显式声明机器可读值：<meta itemprop="price" content="89.99">

嵌套结构中 itemprop 和 itemscope 必须紧邻，不能隔层

当某个 itemprop 的值本身是一个对象（比如作者、地址、评论者），它的 itemscope 必须直接挂在同一个 HTML 元素上，中间不能插入任何 wrapper 容器。否则 Google 会认为该 itemprop 没绑定任何实体，整块嵌套被丢弃。

典型错误：<div itemprop="author"><div itemscope itemtype="https://schema.org/Person">张三</div></div> —— 这里 itemprop="author" 的父元素没带 itemscope，解析器找不到归属。

✅ 正确：<div itemprop="author" itemscope itemtype="https://schema.org/Person">张三</div>
✅ 地址嵌套也一样：<div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress"><span itemprop="streetAddress">XX路123号</span></div>
⚠️ 注意：PostalAddress 要求至少含 streetAddress、addressLocality、addressCountry，缺任一可能导致 LocalBusiness 富摘要失败

隐藏字段和特殊类型要用语义化标签，不能靠纯文本

搜索引擎提取 itemprop 值默认读取 textContent，但很多字段（日期、价格、URL、ID）需要机器可读格式，纯文本极易歧义或失效。

例如：<p itemprop="datePublished">昨天</p> 或 <p itemprop="price">¥299</p> 都不会被识别为有效结构化值。

日期时间必须用 <time itemprop="datePublished" datetime="2026-10-08">2026年10月8日</time>，datetime 属性优先级高于可见文本
URL 类字段（url、image、sameAs）推荐用 <link itemprop="image" href="logo.jpg"> 或 <meta itemprop="url" content="https://example.com">
隐藏字段（SKU、MPN、GTIN）只能用 <meta itemprop="sku" content="ABC-123">，且必须放在同级 itemscope 容器内
<img itemprop="image"> 不生效——itemprop="image" 要求值是字符串 URL，不是 DOM 节点