<meta>:元数据元素

基线 广泛可用

此功能已得到很好的确立,并且可以在许多设备和浏览器版本中使用。它自以下时间起在浏览器中可用 2015 年 7 月.

<meta> HTML 元素表示无法由其他 HTML 元数据相关元素(如 <base><link><script><style><title>)表示的元数据

<meta> 元素提供的元数据类型可以是以下类型之一

  • 如果设置了 name 属性,则 <meta> 元素提供文档级元数据,适用于整个页面。
  • 如果设置了 http-equiv 属性,则 <meta> 元素是pragma 指令,提供的信息等同于可以使用同名 HTTP 标头提供的信息。
  • 如果设置了 charset 属性,则 <meta> 元素是字符集声明,提供文档编码使用的字符编码。
  • 如果设置了 itemprop 属性,则 <meta> 元素提供用户定义的元数据

属性

此元素包含全局属性

注意: 属性 name 对于 <meta> 元素具有特定的含义,并且 itemprop 属性不得设置在与任何现有 namehttp-equivcharset 属性相同的 <meta> 元素上。

charset

此属性声明文档的字符编码。如果存在此属性,则其值必须与字符串 "utf-8" 进行 ASCII 不区分大小写的匹配,因为 UTF-8 是 HTML5 文档中唯一有效的编码。声明字符编码的 <meta> 元素必须完全位于文档的前 1024 字节内。

content

此属性包含 http-equivname 属性的值,具体取决于使用哪个属性。

http-equiv

定义一个编译指示。该属性名为 http-equiv(alent),因为所有允许的值都是特定 HTTP 标头的名称。

  • content-security-policy 允许页面作者为当前页面定义 内容策略。内容策略主要指定允许的服务器来源和脚本端点,这有助于防止跨站点脚本攻击。
  • content-type 声明 MIME 类型 和文档的字符编码。如果指定了 content 属性,则其值必须为 "text/html; charset=utf-8"。这等效于具有 charset 属性指定的 <meta> 元素,并在文档中的放置位置上具有相同的限制。注意: 只能在使用 text/html 提供服务的文档中使用 - 不能在使用 XML MIME 类型提供服务的文档中使用。
  • default-style 设置默认 CSS 样式表 集的名称。
  • x-ua-compatible 如果指定,则 content 属性的值必须为 "IE=edge"。用户代理必须忽略此编译指示。
  • refresh 此指令指定
    • 页面应重新加载之前的秒数 - 仅当 content 属性包含非负整数时。
    • 页面应重定向到另一个页面之前的秒数 - 仅当 content 属性包含非负整数,后跟字符串 ';url=' 和有效 URL 时。
    计时器在页面完全加载时开始,即在 loadpageshow 事件都触发之后。

    警告

    设置了 refresh 值的页面存在时间间隔过短的风险。使用屏幕阅读器等辅助技术的使用者可能无法在自动重定向之前阅读并理解页面的内容。页面内容的突然、未经宣布的更新也可能使视力障碍者感到困惑。

name

namecontent 属性可以一起用于根据名称-值对提供文档元数据,其中 name 属性提供元数据名称,content 属性提供值。

有关 HTML 规范中定义的标准元数据名称集的详细信息,请参阅 标准元数据名称

示例

html
<meta charset="utf-8" />

<!-- Redirect page after 3 seconds -->
<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />

技术摘要

内容类别 元数据内容。如果存在 itemprop 属性:流内容短语内容
允许的内容 无;它是一个 空元素
标签省略 必须有开始标签,并且不得有结束标签。
允许的父元素
隐式 ARIA 角色 无对应角色
允许的 ARIA 角色 不允许使用 role
DOM 接口 HTMLMetaElement

规范

规范
HTML 标准
# the-meta-element

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅