MDN self-hosted library · e01.org

CSSPositionValue

CSS Typed Object Model API

CSS Typed Object Model API

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.

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.

```css hidden

image {

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


```html hidden
<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" />

300

Browser compatibility

See also