Set style properties

style.setProperties(props, options?)

Set multiple style-properties on a Style object.

Syntax

style.setProperties(
props: {{PROPERTY_MAP}},
options?: {
breakpoint?: {{BREAKPOINT_ID}},
pseudo?: {{PSEUDO_STATE_KEY}},
variantId?: {{VARIANT_ID}}
}
): Promise<void>

Parameters

  • props: PropertyMap - An object of style properties and their values. 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 set the style properties for.

      type BreakpointId = "xxl" | "xl" | "large" | "main" | "medium" | "small" | "tiny"
    • pseudo: PseudoStateKey - Specifies a CSS pseudo-class to set the style properties 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

// Create a new style
const newStyle = await webflow.createStyle('MyCustomStyle')
const propertyMap : PropertyMap = {
'background-color': "blue",
'font-size': "16px",
'font-weight': "bold",
}
const myBreakpoint: StyleOptions = { breakpoint: "medium" }
// Set and save properties for the style
await newStyle.setProperties(propertyMap, myBreakpoint);
// Set properties for a specific variant
await newStyle.setProperties(propertyMap, { variantId: 'variant-123' });

Designer ability

Designer AbilityLocaleBranchWorkflowSitemode
canModifyStyleBlocksAnyAnyCanvasDesign