CSSPositionValue: CSSPositionValue() constructor

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() constructor creates a new CSSPositionValue object that represents values for properties that take a position, for example object-position.

Syntax

js
new CSSPositionValue(x, y)

Parameters

x

A position along the web page's horizontal axis.

y

A position along the web page's vertical axis.

Examples

Basic usage

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

js
let someDiv = document.getElementById("container");
let position = new CSSPositionValue(CSS.px(5), CSS.px(10));

someDiv.attributeStyleMap.set("object-position", position);
console.log(position.x.value, position.y.value); // 5 10

Browser compatibility

See also