Set attribute (Beta)

element.setAttribute(name, value) / element.setAttribute(index, entry)

Set a single attribute on an element.

This method supports two calling signatures:

• Pass a name string and a value string to set an attribute by name. In this case you can bind the value by passing a BindingValue object, but you cannot bind the name.

• Pass an index and an AttributeEntry object to update the attribute at that position in the attributes array, with full binding support on both name and value.

To replace the entire set of attributes at once, use element.setAttributes().

Syntax

1
element.setAttribute(name: string, value: string): Promise<AttributeEntry>
2
element.setAttribute(index: number, entry: AttributeEntry): Promise<AttributeEntry>

Parameters

Signature 1 — set by name:

• name : string — The name of the attribute to set.
• value : string — The string value to assign to the attribute.

Signature 2 — set by index:

• index : number — The zero-based position of the attribute in the element’s attributes array.
• entry : AttributeEntry — An object specifying the name and value, each of which can be a string or a BindingValue.

Related types:

1
type AttributeEntry = {
2
  name: string | BindingValue
3
  value: string | BindingValue
4
}

Returns

Promise<AttributeEntry>

A Promise that resolves to the updated attribute entry.

Example

1
const element = await webflow.getSelectedElement()
2
3
if (element && element.attributes) {
4
  // Set by name (string values only)
5
  await element.setAttribute('data-label', 'primary')
6
7
  // Set by index (supports bindings)
8
  await element.setAttribute(0, { name: 'data-label', value: 'primary' })
9
}

Designer Ability