Set style property

style.setProperty(prop, value, options?)

Manage the CSS of a Style by setting a specific style property at the given breakpoint and pseudo-state.

Syntax

style.setProperty(
  prop: {{STYLE_PROPERTY}},
  value: string | VariableReference,
  options?: {
    breakpoint?: {{BREAKPOINT_ID}},
    pseudo?: {{PSEUDO_STATE_KEY}},
    variantId?: {{VARIANT_ID}}
  }
): Promise<void>

Parameters

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

• value: String | VariableReference - The value to set. You can set the value to a string or a variable reference.

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

  • breakpoint: BreakpointId - Identifies the responsive breakpoint to set the style property for.

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

  • pseudo: PseudoStateKey - Specifies a CSS pseudo-class to set the style property 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<null>

A Promise that resolves to null

Example

// Retrieve the style by name
const retrievedStyle = await webflow.getStyleByName(styleName);
// Set a property for a specific breakpoint and pseudo-state
const options: StyleOptions = { breakpoint: "xl", pseudo: "hover" }
await retrievedStyle?.setProperty('background-color', 'blue', options)
// Set a property for a specific variant
await retrievedStyle?.setProperty('color', 'red', { variantId: 'variant-123' })
// Set a property combining variant, breakpoint, and pseudo-state
await retrievedStyle?.setProperty('font-size', '24px', {
  variantId: 'variant-123',
  breakpoint: 'medium',
  pseudo: 'hover',
})

Designer Ability