Get DOM ID (Beta)

element.getDomId()

Get the HTML id attribute of an element, or check whether the ID is bound to a data source.

Verify that the element has the domId property before calling this method.

Syntax

1
element.getDomId(): Promise<string | null>
2
element.getDomId(options: { bindings: true }): Promise<string | BindingValue | null>

Parameters

• options (optional): { bindings: true } — When passed, returns binding metadata instead of the resolved string value if the ID is bound to a data source.

Returns

• Promise<string | null>: The current HTML ID as a string, or null if no ID has been set.
• Promise<string | BindingValue | null> (when { bindings: true } is passed): A BindingValue object if the ID is bound to a data source, or null if no ID has been set.

Example

1
const element = await webflow.getSelectedElement();
2
3
if (element?.domId) {
4
5
  // Get the current DOM ID
6
  const id = await element.getDomId();
7
  console.log(id); // 'hero-section' or null
8
9
  // Read binding metadata
10
  const value = await element.getDomId({ bindings: true });
11
  // Returns BindingValue when bound, or string when static
12
}

Designer Ability

Checks for authorization only.