Public Methods

Public methods are SDK methods that are made available to facilitate your interactions with our SDK, including getting information from the widget configuration and from the current user consent state.

• DidomiWidgets.getContainerById(widgetId)

• DidomiWidgets.updateToken(token)

• container.getEntities()

• container.isConsentPurposeEnabled(purposeId)

• container.getPreferenceValueById({ purposeId, preferenceId })

• container.getEntityContentById({ entityType, entityId, entityProperty, withComponentContent })

• container.getComponentContentById({ componentId, componentProperty })

DidomiWidgets.getContainerById(widgetId)

The SDK allows you to get the configuration object of a published widget using the getContainerbyId method.

const container = await DidomiWidgets.getContainerById("widgetId");

We recommend getting the widget's configuration once the SDK is ready. You can refer to the example here.

DidomiWidgets.updateToken(token)

The SDK allows you to set the user token asynchronously.

const container = await DidomiWidgets.updateToken(YOUR_TOKEN);

container.getEntities()

The SDK provides a method called getEntities that enables you to retrieve entities from your Configuration Tree that are enabled in your widget. From there, you will be able to display purpose and preference choices on your page using our Custom Elements.

  const entities = await container.getEntities();

You will receive the following data. We recommend getting the widget's configuration once the SDK is ready. You can refer to the example here.

container.isConsentPurposeEnabled(purposeId)

The SDK provides a method for checking whether a purpose is enabled or not.

The method, isConsentPurposeEnabled(purposeId) takes the purpose ID as a parameter and returns true or false.

const isPurposeEnabled = container.isConsentPurposeEnabled(purposeId)

container.getPreferenceValueById({ purposeId, preferenceId })

The SDK provides a method for fetching choices selected from a preference.

The method getPreferenceValueById takes the purpose ID and preference ID as parameters and returns a string of IDs separated by commas (,) containing the enabled values.

const enabledValuesAsString = container.getPreferenceValueById({ purposeId, preferenceId });a

container.getEntityContentById({ entityType, entityId, entityProperty, withComponentContent })

The SDK offers a method for displaying the translated content of your entities if you are unable to use our custom elements.

The method getEntityContentById takes the entityType, entityId, entityProperty and withComponentContent as parameters and returns a string with the content requested.

Parameter	Description
entityType	This property determines which content of the entity object should be displayed. It can be name or description.
entityId	ID of the selected purpose, selected preference or preference value. You can easily find them in the Configuration Tree section on the Console.
entityProperty	Specify the type of property. It can be either purpose, preference or preference-value.
withComponentContent	This property is used to determine whether to override the entity content with the layout component one set a widget level, if any (true), or to display the entity content (undefined).

container.getComponentContentById({ componentId, componentProperty })

The SDK offers a method for displaying the translated content of your component if you are unable to use our custom elements.

The method getComponentContentById takes the containerId, componentId and componentCategory as parameters and returns a string with the content requested.

Parameter	Description
componentId	ID of the layout-component
componentProperty	Property of the layout-component. For example saveButton.text.content (if it has been edited at the layout-component level) or bannerImage.src to get the URL of the header banner image for instance.