<object>:外部对象元素

Baseline 已广泛支持

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

<object> HTML 元素表示一个外部资源,它可以被当作图片、嵌套的浏览上下文或者由插件处理的资源。

试一试

<object
  type="video/mp4"
  data="/shared-assets/videos/flower.mp4"
  width="250"
  height="200"></object>

属性

此元素包含全局属性

archive 已弃用

一个由空格分隔的 URI 列表,指向对象的资源归档。

border 已弃用

控件周围边框的宽度,单位为像素。

classid 已弃用

对象实现的 URI。它可以与 data 属性一起使用,也可以代替它。

codebase 已弃用

用于解析由 classiddataarchive 指定的相对 URI 的基本路径。如果未指定,则默认为当前文档的基本 URI。

codetype 已弃用

classid 指定的数据的内容类型。

data

资源的地址,为一个有效的 URL。datatype 必须至少定义一个。

declare 已弃用

该布尔属性的存在使此元素仅作为声明。对象必须由后续的 <object> 元素实例化。每次重用资源时,都应完整地重复 <object> 元素。

form

对象元素关联的表单元素(若有),即其“表单所有者”。该属性的值必须是同一文档中某个 <form> 元素的 ID。

height

所显示资源的高度,以 CSS 像素为单位的 <integer> 值。

name

有效浏览上下文的名称(HTML5),或控件的名称(HTML 4)。该名称成为 WindowDocument 对象的属性,其中包含对嵌入窗口或元素本身的引用。

standby 已弃用

一条消息,浏览器可以在加载对象的实现和数据时显示。

type

data 指定的资源的内容类型datatype 必须至少定义一个。

usemap 已弃用

指向 <map> 元素的哈希名称引用;即一个“#”后跟一个 map 元素的 name 属性的值。

width

所显示资源的宽度,以 CSS 像素为单位的 <integer> 值。

示例

嵌入一个视频

HTML

html
<object
  type="video/webm"
  data="/shared-assets/videos/flower.webm"
  width="600"
  height="140">
  <img
    src="/shared-assets/images/examples/flowers.jpg"
    alt="Some beautiful flowers" />
</object>

结果

如果示例中的视频加载失败,将为用户提供一张图片作为后备内容。使用 <img> 标签来显示图片。我们设置了 src 属性,指向要嵌入的图片的路径。我们还设置了 alt 属性,为图片提供一个无障碍名称。如果图片也加载失败,将显示 alt 属性的内容。

技术摘要

内容类别 流式内容短语内容嵌入式内容;可感知内容;若元素拥有 usemap 属性,则为交互式内容可列出可提交表单关联元素。
允许内容 零个或多个 <param> 元素,然后是透明内容
标签省略 无,起始标签和结束标签都必须存在。
允许父级 任何接受嵌入式内容的元素。
隐式 ARIA 角色 没有对应的角色
允许的 ARIA 角色 applicationdocumentimg
DOM 接口 HTMLObjectElement

规范

规范
HTML
# the-object-element

浏览器兼容性

另见