CSSPositionTryRule

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The CSSPositionTryRule interface describes an object representing a @position-try at-rule.

CSSRule CSSPositionTryRule

Instance properties

Inherits properties from its ancestor CSSRule.

CSSPositionTryRule.name Read only Experimental

Represents the name of the position try option specified by the @position-try at-rule's <dashed-ident>.

CSSPositionTryRule.style Read only Experimental

Returns a CSSPositionTryDescriptors object representing the declarations set in the body of the @position-try at-rule.

Instance methods

No specific methods; inherits methods from its ancestor CSSRule.

Examples

The CSS includes a @position-try at-rule with a name of --custom-left and three descriptors.

css
@position-try --custom-left {
  position-area: left;
  width: 20%;
  max-width: 200px;
  margin: 0 10px 0 0;
}
js
const myRules = document.styleSheets[0].cssRules;
const tryOption = myRules[0]; // a CSSPositionTryRule
console.log(tryOption); // "[object CSSPositionTryRule]"
console.log(tryOption.name); // "--custom-left"
console.log(tryOption.style); // "[object CSSPositionTryDescriptors]"
console.log(tryOption.style.maxWidth); // "200px"

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android
CSSPositionTryRule 125 125 No 111 No 125 No 83 No No 125
name 125 125 No 111 No 125 No 83 No No 125
style 125 125 No 111 No 125 No 83 No No 125

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CSSPositionTryRule