CSSPositionValue

已棄用：此特性不再推薦。雖然某些瀏覽器可能仍然支援它，但它可能已經從相關的網路標準中刪除，可能正在刪除過程中，或者可能僅為相容性目的而保留。請避免使用它，如果可能，請更新現有程式碼；請參閱本頁底部的相容性表格以指導您的決策。請注意，此特性可能隨時停止工作。

非標準：此特性未標準化。我們不建議在生產環境中使用非標準特性，因為它們瀏覽器支援有限，並且可能會更改或被移除。但是，在沒有標準選項的特定情況下，它們可以是合適的替代方案。

CSSPositionValue 介面是 CSS 型別化物件模型 API 的一部分，用於表示需要位置值的 CSS 屬性，例如 object-position。

建構函式

CSSPositionValue() 非標準已棄用: 建立一個新的 CSSPositionValue 物件。

例項屬性

CSSPositionValue.x 非標準已棄用: 返回專案在網頁水平軸上的位置。
CSSPositionValue.y 非標準已棄用: 返回專案在垂直軸上的位置。

例項方法

無。

示例

以下示例將一個容器 <div> 定位在距離頁面頂部 5 畫素、距離頁面左側 10 畫素的位置。

const replacedEl = document.getElementById("image");
const position = new CSSPositionValue(CSS.px(35), CSS.px(40));

replacedEl.attributeStyleMap.set("object-position", position);
console.log(position.x.value, position.y.value);
console.log(replacedEl.computedStyleMap().get("object-position"));

我們設定了 object-position 屬性，然後檢查返回的值。

#image {
  width: 300px;
  height: 300px;
  border: 1px solid black;
  background-color: #dededf;
  object-fit: none;
}

<p>
  Check the developer tools to see the log in the console and to inspect the
  style attribute on the image.
</p>
<img id="image" src="mdn.svg" alt="MDN Logo" />

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2023年2月19日，由 MDN 貢獻者修改。

在 GitHub 上檢視此頁面 • 報告此內容的問題