Get style property

style.getProperty(prop, options?)

Retrieve the value of a specific css property in a Style object.

Syntax

style.getProperty(
  prop: {{STYLE_PROPERTY}},
  options?: {
    breakpoint?: {{BREAKPOINT_ID}},
    pseudo?: {{PSEUDO_STATE_KEY}},
    variantId?: {{VARIANT_ID}}
  }
): Promise<null | {{PROPERTY_MAP}}>

Parameters

• prop: StyleProperty - The property to get. See the Style Properties reference for a list of supported properties.

• options: StyleOptions - An object that filters properties by breakpoint, pseudo-state, and/or variant. (Optional)

  • breakpoint: BreakpointId - Identifies the responsive breakpoint to get styles for.

    type BreakpointId = "xxl" | "xl" | "large" | "main" | "medium" | "small" | "tiny"

  • pseudo: PseudoStateKey - Specifies a CSS pseudo-class to get styles for.

    type PseudoStateKey = "noPseudo" | "nth-child(odd)" | "nth-child(even)" |
      "first-child" | "last-child" | "hover" | "active" |
      "visited" | "focus" | "focus-visible" | "focus-within" |
      "placeholder" | "empty" | "before" | "after"

  • variantId: string - The ID of the variant to target. 'base' is not a valid value. (Optional)

Returns

Promise<PropertyMap[p] | Variable | null>

Returns a Promise that resolves to:

• PropertyMap[p] - The value of the provided style property, if one exists.
• A Variable representing the value of the provided style property, if a variable is used as the value of the provided style property.
• null - If value doesn’t exist for the provided style property, this method will return null.

Example

// Get Selected Element
const selectedElement = await webflow.getSelectedElement()
// Get Element Styles
if (selectedElement?.styles) {
    const styles = await selectedElement.getStyles()
    const selectedPropertyList = await Promise.all(styles.map(async style => {
      const styleName = await style.getName()
      const property = await style.getProperty(`box-shadow`)
      console.log(`Style Name: ${styleName}, box-shadow: ${property}`)
    }))
  }

Designer Ability

Checks for authorization only