Back to Content

CSSPositionTryRule

files/en-us/web/api/csspositiontryrule/index.md

latest1.8 KB
Original Source

{{APIRef("CSSOM")}}

The CSSPositionTryRule interface describes an object representing a {{cssxref("@position-try")}} at-rule.

{{InheritanceDiagram}}

Instance properties

Inherits properties from its ancestor {{domxref("CSSRule")}}.

  • {{domxref("CSSPositionTryRule.name")}} {{ReadOnlyInline}}
    • : Represents the name of the position try option specified by the @position-try at-rule's {{cssxref("dashed-ident")}}.
  • {{domxref("CSSPositionTryRule.style")}} {{ReadOnlyInline}}
    • : A {{domxref("CSSPositionTryDescriptors")}} object that represents the declarations set in the body of the @position-try at-rule.

Instance methods

No specific methods; inherits methods from its ancestor {{domxref("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-right: 10px;
}
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

{{Specifications}}

Browser compatibility

{{Compat}}

See also