<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

瀏覽器相容性

另見