CSSPositionValue

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

Non-standard: This feature is not standardized. We do not recommend using non-standard features in production, as they have limited browser support, and may change or be removed. However, they can be a suitable alternative in specific cases where no standard option exists.

The CSSPositionValue interface of the CSS Typed Object Model API represents values for properties that take a position, for example object-position.

Constructor

CSSPositionValue()

Creates a new CSSPositionValue object.

Instance properties

CSSPositionValue.x

Returns the item's position along the web page's horizontal axis.

CSSPositionValue.y

Returns the item's position along the vertical axis.

Instance methods

None.

Examples

The following example positions a container <div> 5 pixels from the top and 10 pixels from the left of the page.

js
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"));

We set the object-position property, then check the values returned.

Browser compatibility

See also