CSSPositionTryDescriptors
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("CSSOM")}}
The **CSSPositionTryDescriptors** interface defines properties that represent the list of CSS descriptors that can be set in the body of a {{cssxref("@position-try")}} at-rule.
Each descriptor in the body of the corresponding {{cssxref("@position-try")}} at-rule can be accessed using either its property name in bracket notation or the camel-case version of the property name "propertyName" in dot notation. For example, you can access the CSS property "property-name" as style["property-name"] or style.propertyName, where style is a CSSPositionTryDescriptors instance. A property with a single-word name like {{cssxref("height")}} can be accessed using either notation: style["height"] or style.height.
توجه: The {{domxref("CSSPositionTryRule")}} interface represents a {{cssxref("@position-try")}} at-rule, and the {{domxref("CSSPositionTryRule.style")}} property is an instance of this object.
{{InheritanceDiagram}}
Instance properties
_Inherits properties from its ancestor {{domxref("CSSStyleDeclaration")}}._
The following property names, in snake-case (accessed using bracket notation) and camel-case (accessed using dot notation), each represent the value of a descriptor in the corresponding @position-try at-rule:
align-selforalignSelf- : A string representing the value of an {{cssxref("align-self")}} descriptor.
block-sizeorblockSize- : A string representing the value of a {{cssxref("block-size")}} descriptor.
bottom- : A string representing the value of a {{cssxref("bottom")}} descriptor.
height- : A string representing the value of a {{cssxref("height")}} descriptor.
inline-sizeorinlineSize- : A string representing the value of an {{cssxref("inline-size")}} descriptor.
inset- : A string representing the value of an {{cssxref("inset")}} descriptor.
position-areaorpositionArea- : A string representing the value of a {{cssxref("position-area")}} descriptor.
inset-blockorinsetBlock- : A string representing the value of an {{cssxref("inset-block")}} descriptor.
inset-block-endorinsetBlockEnd- : A string representing the value of an {{cssxref("inset-block-end")}} descriptor.
inset-block-startorinsetBlockStart- : A string representing the value of an {{cssxref("inset-block-start")}} descriptor.
inset-inlineorinsetInline- : A string representing the value of an {{cssxref("inset-inline")}} descriptor.
inset-inline-endorinsetInlineEnd- : A string representing the value of an {{cssxref("inset-inline-end")}} descriptor.
inset-inline-startorinsetInlineStart- : A string representing the value of an {{cssxref("inset-inline-start")}} descriptor.
justify-selforjustifySelf- : A string representing the value of a {{cssxref("justify-self")}} descriptor.
left- : A string representing the value of a {{cssxref("left")}} descriptor.
margin- : A string representing the value of a {{cssxref("margin")}} descriptor.
margin-blockormarginBlock- : A string representing the value of a {{cssxref("margin-block")}} descriptor.
margin-block-endormarginBlockEnd- : A string representing the value of a {{cssxref("margin-block-end")}} descriptor.
margin-block-startormarginBlockStart- : A string representing the value of a {{cssxref("margin-block-start")}} descriptor.
margin-bottomormarginBottom- : A string representing the value of a {{cssxref("margin-bottom")}} descriptor.
margin-inlineormarginInline- : A string representing the value of a {{cssxref("margin-inline")}} descriptor.
margin-inline-endormarginInlineEnd- : A string representing the value of a {{cssxref("margin-inline-end")}} descriptor.
margin-inline-startormarginInlineStart- : A string representing the value of a {{cssxref("margin-inline-start")}} descriptor.
margin-leftormarginLeft- : A string representing the value of a {{cssxref("margin-left")}} descriptor.
margin-rightormarginRight- : A string representing the value of a {{cssxref("margin-right")}} descriptor.
margin-topormarginTop- : A string representing the value of a {{cssxref("margin-top")}} descriptor.
max-block-sizeormaxBlockSize- : A string representing the value of a {{cssxref("max-block-size")}} descriptor.
max-heightormaxHeight- : A string representing the value of a {{cssxref("max-height")}} descriptor.
max-inline-sizeormaxInlineSize- : A string representing the value of a {{cssxref("max-inline-size")}} descriptor.
max-widthormaxWidth- : A string representing the value of a {{cssxref("max-width")}} descriptor.
min-block-sizeorminBlockSize- : A string representing the value of a {{cssxref("min-block-size")}} descriptor.
min-heightorminHeight- : A string representing the value of a {{cssxref("min-height")}} descriptor.
min-inline-sizeorminInlineSize- : A string representing the value of a {{cssxref("min-inline-size")}} descriptor.
min-widthorminWidth- : A string representing the value of a {{cssxref("min-width")}} descriptor.
place-selforplaceSelf- : A string representing the value of a {{cssxref("place-self")}} descriptor.
position-anchororpositionAnchor- : A string representing the value of a {{cssxref("position-anchor")}} descriptor.
right- : A string representing the value of a {{cssxref("right")}} descriptor.
top- : A string representing the value of a {{cssxref("top")}} descriptor.
width- : A string representing the value of a {{cssxref("width")}} descriptor.
Instance methods
_No specific methods; inherits methods from its ancestor {{domxref("CSSStyleDeclaration")}}._
Examples
The CSS includes a @position-try at-rule with a name of --custom-right and three descriptors.
@position-try --custom-right {
position-area: right;
width: 100px;
margin-left: 10px;
}const myRules = document.styleSheets[0].cssRules;
const tryOption = myRules[0]; // a CSSPositionTryRule
console.log(tryOption.style); // "[object CSSPositionTryDescriptors]"
console.log(tryOption.style.margin); // "0 0 0 10px"
console.log(tryOption.style["position-area"]); // "right"Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{DOMxRef("CSSPositionTryRule")}}
- {{cssxref("@position-try")}}
- {{cssxref("position-try-fallbacks")}}
- CSS anchor positioning module
- Using CSS anchor positioning
- Handling overflow: try options and conditional hiding