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

1
 style.setProperty(
2
  prop: {{STYLE_PROPERTY}}, 
3
  value: string | VariableReference,
4
  options?: {
5
    breakpointId?: {{BREAKPOINT_ID}},
6
    pseudoStateKey?: {{PSEUDO_STATE_KEY}}
7
  }
8
): 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: BreakpointAndPseudo - An object that lets you filter properties by breakpoint and/or pseudo-state. (Optional)

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

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

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

A Promise that resolves to null

Example

1
// Retrieve the style by name
2
const retrievedStyle = await webflow.getStyleByName(styleName);
3
4
// Set Style Properties
5
const options: BreakpointAndPseudo = { breakpoint: "xl", pseudo: "hover" }
6
await retrievedStyle?.setProperty('background-color', 'blue', options)

Designer Ability