HTML <meta> 元素表示那些不能由其他 HTML 元相关(meta-related)元素表示的Metadata信息。如:base、link、script、style 或 title。
<table class="properties"> <tbody> <tr> <th> <a href="/zh-CN/docs/Web/HTML/Guides/Content_categories" >内容分类</a > </th> <td> <a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#元数据内容" >元数据内容</a >。如果 <a href="/zh-CN/docs/Web/HTML/Reference/Global_attributes/itemprop"><code>itemprop</code></a> 属性存在:<a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#流式内容" >流式内容</a >、<a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#分段内容" >分段内容</a> </td> </tr> <tr> <th>允许的内容</th> <td>无;这是一个void element。</td> </tr> <tr> <th>标签省略</th> <td> 由于这是一个空元素,所以必须有开始标签并且不能有结束标签。 </td> </tr> <tr> <th>允许的父元素</th> <td> <ul> <li> <code><meta charset></code>、<code ><meta http-equiv></code>:head 元素。如果 <a href="/zh-CN/docs/Web/HTML/Reference/Elements/meta#http-equiv"><code>http-equiv</code></a> 不是编码声明,它也可以放在 noscript 元素中,它本身在一个 <code><head></code> 元素内部。 </li> <li> <code><meta name></code>:任何可以接受<a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#元数据内容" >元数据内容</a >的元素。 </li> <li> <code><meta itemprop></code>:任何可以接受<a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#元数据内容" >元数据内容</a >或<a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#流式内容" >流式内容</a >。 </li> </ul> </td> </tr> <tr> <th scope="row">默认的无障碍角色</th> <td> <a href="https://www.w3.org/TR/html-aria/#dfn-no-corresponding-role" >没有相应的角色</a > </td> </tr> <tr> <th scope="row">允许的无障碍角色</th> <td>没有允许的<code>角色(role)</code></td> </tr> <tr> <th>DOM 接口</th> <td>HTMLMetaElement</td> </tr> </tbody> </table>
<meta> 元素定义的元数据的类型包括以下几种:
- 如果设置了
name属性,<meta>元素提供的是文档级别(document-level)的元数据,应用于整个页面。 - 如果设置了
http-equiv属性,<meta>元素则是编译指令,提供的信息与类似命名的 HTTP 头部相同。 - 如果设置了
charset属性,<meta>元素是一个字符集声明,告诉文档使用哪种字符编码。 - 如果设置了
itemprop属性,<meta>元素提供用户定义的元数据。
属性
此元素包括全局属性。
[!NOTE]
name属性在<meta>元素中具有特殊的语义;另外,当一个<meta>标签中,有name、http-equiv或者charset三者中任何一个属性时,itemprop属性不能被使用。
-
charset- : 该属性声明了文档的字符编码。如果存在该属性,则其值必须是字符串
"utf-8"的不区分 ASCII 大小写的匹配,因为 UTF-8 是 HTML5 文档的唯一有效编码。声明字符编码的<meta>元素必须完全位于文档的前 1024 个字节内。
- : 该属性声明了文档的字符编码。如果存在该属性,则其值必须是字符串
-
content- : 此属性包含
http-equiv或name属性的值,具体取决于所使用的值。
- : 此属性包含
-
http-equiv- : 属性定义了一个编译指示指令。这个属性叫做
http-equiv(alent)是因为所有允许的值都是特定 HTTP 标头的名称,如下:-
content-security-policy允许页面作者定义当前页面的内容策略。内容策略常用来指定允许的服务器源和脚本端点,这有助于防止跨站点脚本攻击。 -
content-type声明 MIME 类型和文档的字符编码。如果使用content-type属性,与之在同一个<meta>元素中使用的content属性的值必须是"text/html; charset=utf-8"。这相当于一个具有指定charset属性的<meta>元素,并对其在文档中的放置位置有相同的限制。注意:该属性只能用于 MIME 类型为text/html的文档,不能用于 MIME 类型为 XML 的文档。 -
default-style设置默认 CSS 样式表组的名称。
-
x-ua-compatible如果指定,则content属性必须具有值"IE=edge"。用户代理必须忽略此指示。 -
refresh这个属性指定:- 页面重新加载的秒数——仅当
content属性包含非负整数时。 - 页面重定向到指定链接的秒数——仅当 content 属性包含非负整数后跟字符串“
;url=”和有效的 URL 时。
[!WARNING]
设置了
refresh值的页面存在时间间隔过短的风险。借助屏幕阅读器等辅助技术进行导航的用户可能无法在自动重定向之前通读和理解页面内容。突然的、未通知的页面内容更新也可能会让视力低下的人迷失方向。- MDN Understanding WCAG, Guideline 2.1 explanations
- MDN Understanding WCAG, Guideline 3.1 explanations
- Understanding Success Criterion 2.2.1 | W3C Understanding WCAG 2.0
- Understanding Success Criterion 2.2.4 | W3C Understanding WCAG 2.0
- Understanding Success Criterion 3.2.5 | W3C Understanding WCAG 2.0
- 页面重新加载的秒数——仅当
-
- : 属性定义了一个编译指示指令。这个属性叫做
-
name- :
name和content属性可以一起使用,以名 - 值对的方式给文档提供元数据,其中 name 作为元数据的名称,content 作为元数据的值。 在标准元数据名称中查看 HTML 规范等规范中定义的标准元数据名称。
- :
示例
<meta charset="utf-8" />
<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />
规范
浏览器兼容性
参见
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
