<meta>:元数据元素

Baseline 广泛可用 *

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

* 此特性的某些部分可能存在不同级别的支持。

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

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

  • 如果设置了 name 属性,<meta> 元素会提供适用于整个页面的文档级元数据
  • 如果设置了 http-equiv 属性,<meta> 元素将充当pragma指令,模拟原本可以由 HTTP 头部给出的指令。
  • 如果设置了 charset 属性,<meta> 元素将是字符集声明,指示文档所使用的字符编码。
  • 如果设置了 itemprop 属性,<meta> 元素将提供用户自定义元数据

属性

此元素包含全局属性

注意: name 属性对 <meta> 元素有特定含义。如果 <meta> 元素包含 namehttp-equivcharset 属性,则不得设置 itemprop 属性。

字符集

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

content

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

http-equiv

定义一个 pragma 指令,这些指令是浏览器处理文档的指示。该属性的名称是 http-equivalent 的缩写,因为允许的值是等效 HTTP 标头名称。

媒体

media 属性定义了 content 属性中定义的“主题颜色”应应用于哪些媒体。其值是一个 媒体查询,如果属性缺失,则默认为 all。此属性仅在元素的 name 属性设置为 theme-color 时才相关。否则,它没有效果,不应包含。

name

namecontent 属性可以结合使用,以名称-值对的形式提供文档元数据,其中 name 属性给出元数据名称,content 属性给出值。

示例

设置 meta 描述

以下 <meta> 标签为网页提供了一个 description 作为元数据:

html
<meta
  name="description"
  content="The HTML reference describes all elements and attributes of HTML, including global attributes that apply to all elements." />

设置页面重定向

以下示例使用 http-equiv="refresh" 来指示浏览器执行重定向。content="3;url=https://www.mozilla.org" 属性将在 3 秒后将页面重定向到 https://www.mozilla.org

html
<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />

技术摘要

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

规范

规范
HTML
# the-meta-element

浏览器兼容性

另见