此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

<embed> HTML 嵌入外部内容元素

基线 广泛可用

自 2015年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

<embed> HTML 元素会在文档的指定位置嵌入外部内容。该内容由外部应用程序或其他交互内容来源(例如浏览器插件)提供。

尝试一下

<embed
  type="image/jpeg"
  src="/shared-assets/images/examples/flowers.jpg"
  width="250"
  height="200" />

备注:本文仅记录作为 HTML 动态标准一部分所定义的元素,不涉及该元素早期的非标准化实现。

请注意,大多数现代浏览器已弃用并移除了对浏览器插件的支持,因此若希望站点能在普通用户的浏览器中正常使用,通常不宜依赖 <embed>

属性

此元素的属性包括全局属性

height

资源的显示高度,以 CSS 像素为单位。必须为绝对值;不允许使用百分比。

src

所嵌入资源的 URL。

type

用于选择要实例化的插件的 MIME 类型

width

资源的显示宽度,以 CSS 像素为单位。必须为绝对值;不允许使用百分比。

使用说明

可以使用 object-position 属性调整嵌入对象在元素框架内的定位。

备注:object-fit 属性对 <embed> 元素无效。

无障碍

embed 元素上使用 title 属性为其内容添加标签,以便使用屏幕阅读器等辅助技术浏览的人能够理解其中包含的内容。title 的值应简洁描述所嵌入的内容。若没有标题,他们可能无法判断嵌入内容是什么。这种上下文切换可能令人困惑且耗时,尤其是在 embed 元素包含视频或音频等交互内容时。

示例

html
<embed
  type="video/quicktime"
  src="movie.mov"
  width="640"
  height="480"
  title="我的视频标题" />

技术概要

内容类别 流式内容短语内容嵌入内容交互内容可感知内容
允许的内容 无;这是一个空元素
标签省略 必须有开始标签,且不能有结束标签。
允许的父元素 接受嵌入内容的任何元素。
隐式 ARIA 角色 无对应角色
允许的 ARIA 角色 applicationdocumentimgnonepresentation
DOM 接口 HTMLEmbedElement

规范

规范
HTML
# the-embed-element

浏览器兼容性

参见