如何使用HTML itemtype属性定义组织信息-html教程-PHP中文网

itemtype必须与itemscope配合使用才有效，单独使用无效；URI须为https://schema.org/类型且完整；Organization必需name，推荐补全url和sameAs；logo应直接用link或img标记；嵌套Address时需严格遵循PostalAddress属性名大小写及ISO国家码。

如何使用html itemtype属性定义组织信息

itemtype 必须配合 itemscope 使用才有效

单独写 itemtype 没有任何结构化效果，浏览器和搜索引擎完全忽略。它只是 Schema.org 类型的 URI 标识符，必须嵌套在带 itemscope 的元素内才能激活语义解析。

常见错误是只加 itemtype="https://schema.org/Organization" 而忘了外层 itemscope，结果页面里什么结构化数据都出不来。

<div itemscope itemtype="https://schema.org/Organization"> ✅ 正确起点 <li><code><div itemtype="https://schema.org/Organization"> ❌ 无效，被当普通属性丢弃 <li>URI 必须完整且准确，<code>http://schema.org/Organization（HTTP）已过时，应统一用 https://schema.org/Organization

Organization 必需属性只有 name，但实际几乎总要补 url 和 sameAs

Schema.org 官方定义中，Organization 的 name 是 required 字段，其余全是 optional。但 Google 搜索富媒体结果（如公司知识面板）实际依赖更多字段，漏掉会导致结构化数据通过验证却无法触发展示。

实操中至少补全三项：

name：用 itemprop="name" 标记组织全称（不能是 logo 图片 alt）
url：指向官网首页的绝对 URL，用 itemprop="url"
sameAs：列出权威社交主页（如 GitHub、LinkedIn），多个用空格分隔，itemprop="sameAs"

示例片段：

<div itemscope itemtype="https://schema.org/Organization">
  <span itemprop="name">Acme Corp</span>
  <link itemprop="url" href="https://acme.example.com/">
<link itemprop="sameAs" href="https://linkedin.com/company/acme">
<link itemprop="sameAs" href="https://github.com/acme">
</div>

logo 和 image 属性容易混淆，必须用 link 或 img + itemprop

logo 是 Organization 的独立属性，类型是 ImageObject 或直接 URL；而 image 是通用属性，也可用于 Organization，但语义较弱。Google 明确推荐用 logo。

HTML Text Extract

从HTML页面（URL、文件或标准输入）中提取主体内容文本，去除导航、页脚、广告和模板文本。可直接传递给readability_check或其他文本工具。

下载

两种合法写法：

用 <link>：简洁，适合无视觉 logo 的页面（如 JSON-LD 已存在时做补充）
<link itemprop="logo" href="https://acme.example.com/logo.svg">
用 <img>：需同时满足 itemprop="logo" 和 src，alt 可为空或描述性文字，但不可缺 src
<img itemprop="logo" src="/logo.png" alt="Acme Corp logo">

错误写法：<div itemprop="logo"><img src="..."></div> —— logo 不接受包裹式标记，会解析失败。

嵌套 Address 时 itemprop 值必须小写，且 postalCode 等字段有固定拼写

组织地址不是自由文本，必须用 address 属性嵌套 PostalAddress 类型。此时所有子属性名必须严格匹配 Schema.org 定义，大小写敏感，比如 postalCode 不能写成 postalcode 或 zipCode。

关键点：

外层 address 用 itemprop="address"，内层必须加 itemscope itemtype="https://schema.org/PostalAddress"
国家码必须用 ISO 3166-1 alpha-2，如 US、CN，不能写 USA 或 China
streetAddress 可合并多行，但每行需用 <br> 或独立 <span></span>，不能靠换行符解析

示例：

<div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
  <span itemprop="streetAddress">123 Main St</span><br><span itemprop="addressLocality">San Francisco</span>,
  <span itemprop="addressRegion">CA</span>
  <span itemprop="postalCode">94105</span>
  <span itemprop="addressCountry">US</span>
</div>

Google 的结构化数据测试工具能即时反馈拼写错误，但不会提示你漏了 itemscope —— 那类问题只能靠人工核对闭合标签和属性配对。真正上线前，建议用 itemscope 开头、逐层缩进写，避免嵌套错位。