Contact us
Create app
com.vaadin.flow.component.webcomponent.
Package com.vaadin.flow.component.webcomponent

Class WebComponent<C extends Component>

java.lang.Object
com.vaadin.flow.component.webcomponent.WebComponent<C>

Type Parameters:

C - type of the component exported as web component

All Implemented Interfaces:

Serializable

public final class WebComponent<C extends Component> extends Object implements Serializable

Acts as a proxy to the web component root onto which the exporter Component is added. Allows updating web component properties and firing custom events on the client-side.

Since:

2.0

Author:

Vaadin Ltd.

See Also:

  • Constructor Details

    • WebComponent

      public WebComponent(WebComponentBinding binding, Element componentHost)

      Constructs a WebComponent. WebComponentBinding provides the instance of the Component exported as a web component. Binding also defines the properties the web component has. Element is the host element which contains the exported component instance (provided by the binding).

      Parameters:

      binding - binds web component configuration to component X

      componentHost - host component X on the embedding page

      See Also:

  • Method Details

    • fireEvent

      public void fireEvent(String eventName)

      Fires a custom event on the client-side originating from the web component. This event does not bubble in the DOM hierarchy.

      Parameters:

      eventName - name of the event, not null

      See Also:

    • fireEvent

      public void fireEvent(String eventName, elemental.json.JsonValue objectData)

      Fires a custom event on the client-side originating from the web component with custom event data. This event does not bubble in the DOM hierarchy.

      Parameters:

      eventName - name of the event, not null

      objectData - data the event should carry. This data is placed as the detail property of the event, nullable

      See Also:

    • fireEvent

      public void fireEvent(String eventName, elemental.json.JsonValue objectData, EventOptions options)

      Fires a custom event on the client-side originating from the web component with custom event data. Allows modifying the default event behavior with EventOptions.

      Parameters:

      eventName - name of the event, not null

      objectData - data the event should carry. This data is placed as the detail property of the event, nullable

      options - event options for bubbles, cancelable, and composed flags, not null

      Throws:

      NullPointerException - if either eventName or options is null

    • setProperty

      public <P extends Serializable> void setProperty(PropertyConfiguration<C,P> propertyConfiguration, P value)

      Sets property value on the client-side to the given value. The required PropertyConfigurationImpl is received from WebComponentExporter when a new property is added for the web component.

      Type Parameters:

      P - type of the property value being set. If the type does not match the original property type, throws an exception

      Parameters:

      propertyConfiguration - identifies the property for which the value is being set, not null

      value - new value for the property, can be null

      Throws:

      NullPointerException - if propertyConfiguration is null

      IllegalArgumentException - if PropertyConfiguration is not a correct implementation

      IllegalArgumentException - if the web component does not have a property identified by propertyConfiguration

      IllegalArgumentException - the provided value is not of the type expected by the property

Copyright © 2025. All rights reserved.