Get style property

style.getProperty(prop, options?)

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

Syntax

1
 style.getProperty(prop: StyleProperty, options?: BreakpointAndPseudo): Promise<null | PropertyMap[p]>

Parameters

• options: BreakpointAndPseudo (optional)

  An object that lets you filter properties by breakpoint and/or pseudo-state.

  1
  {
  2
    breakpoint?: BreakpointId
  3
    pseudo?: PseudoStateKey
  4
  }

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

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

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

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

Returns

Promise<PropertyMap | 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 does not exist for the provided style property, this method will return null.

Example

1
// Get Selected Element
2
const selectedElement = await webflow.getSelectedElement()
3
4
// Get Element Styles
5
if (selectedElement?.styles) {
6
7
    const styles = await selectedElement.getStyles()
8
    const selectedPropertyList = await Promise.all(styles.map(async style => {
9
10
      const styleName = await style.getName()
11
      const property = await style.getProperty(`box-shadow`)
12
      console.log(`Style Name: ${styleName}, box-shadow: ${property}`)
13
14
    }))
15
16
  }

Designer Ability

Checks for authorization only