<embed> HTML 元素会在文档的指定位置嵌入外部内容。该内容由外部应用程序或其他交互内容来源(例如浏览器插件)提供。
HTML 演示:<embed>
<embed
type="image/jpeg"
src="/shared-assets/images/examples/flowers.jpg"
width="250"
height="200" />
[!NOTE] 本文仅记录作为 HTML 动态标准一部分所定义的元素,不涉及该元素早期的非标准化实现。
请注意,大多数现代浏览器已弃用并移除了对浏览器插件的支持,因此若希望站点能在普通用户的浏览器中正常使用,通常不宜依赖 <embed>。
属性
此元素的属性包括全局属性。
height- : 资源的显示高度,以 CSS 像素为单位。必须为绝对值;不允许使用百分比。
src- : 所嵌入资源的 URL。
type- : 用于选择要实例化的插件的 MIME type。
width- : 资源的显示宽度,以 CSS 像素为单位。必须为绝对值;不允许使用百分比。
使用说明
可以使用 object-position 属性调整嵌入对象在元素框架内的定位。
[!NOTE] object-fit 属性对
<embed>元素无效。
无障碍
在 embed 元素上使用 title 属性为其内容添加标签,以便使用屏幕阅读器等辅助技术浏览的人能够理解其中包含的内容。title 的值应简洁描述所嵌入的内容。若没有标题,他们可能无法判断嵌入内容是什么。这种上下文切换可能令人困惑且耗时,尤其是在 embed 元素包含视频或音频等交互内容时。
示例
<embed
type="video/quicktime"
src="movie.mov"
width="640"
height="480"
title="我的视频标题" />
技术概要
<table class="properties"> <tbody> <tr> <th scope="row"> <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/Guides/Content_categories#短语内容" >短语内容</a >、<a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#嵌入内容" >嵌入内容</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 scope="row">允许的内容</th> <td>无;这是一个void element。</td> </tr> <tr> <th scope="row">标签省略</th> <td>必须有开始标签,且不能有结束标签。</td> </tr> <tr> <th scope="row">允许的父元素</th> <td>接受嵌入内容的任何元素。</td> </tr> <tr> <th scope="row">隐式 ARIA 角色</th> <td> <a href="https://w3c.github.io/html-aria/#dfn-no-corresponding-role" >无对应角色</a > </td> </tr> <tr> <th scope="row">允许的 ARIA 角色</th> <td> <a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/application_role"><code>application</code></a>、<a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/document_role"><code>document</code></a>、<a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/img_role"><code>img</code></a>、<a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/none_role"><code>none</code></a>、<a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/presentation_role"><code>presentation</code></a> </td> </tr> <tr> <th scope="row">DOM 接口</th> <td>HTMLEmbedElement</td> </tr> </tbody> </table>
规范
浏览器兼容性
参见
- 用于嵌入各类内容的其他元素包括 audio、canvas、iframe、img、math、object、svg 和 video。
- 在框架内定位与调整嵌入内容的尺寸:object-position 和 object-fit
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
