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 {
  inset-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

Specification
CSS Anchor Positioning
# csspositiontryrule

Browser compatibility

BCD tables only load in the browser

See also