Defines a specialized form item that holds an external component.

WEBCOMPONENT item basics

The WEBCOMPONENT form item defines a form field that will hold an external component, implemented with a front-end plug-in mechanism.

This topic describes the WEBCOMPONENT item type in form definition files. For more details see the chapter dedicated to web component programming.


The COMPONENTTYPE attribute identifies gICAPI external objects to be used for the field. The PROPERTIES attribute is typically used to define attributes that are specific to a given gICAPI-based web component. For example, a chart component might have properties to define x-axis and y-axis labels. For more details, see Using a gICAPI web component.

If the COMPONENTTYPE attribute is not used, the web component will be a URL-based web component. For more details, see Using a URL-based web component.

Front-ends support different presentation and behavior options, which can be controlled by a STYLE attribute. For more details, see Style attributes common to all elements.

Where to use a WEBCOMPONENT

A WEBCOMPONENT form item can be defined in different ways:
  1. With an item tag and a WEBCOMPONENT item definition in a grid-layout container (GRID, SCROLLGRID and TABLE).
  2. As a WEBCOMPONENT stack item in a STACK container.

Built-in Web Components

Genero BDL provides a set of ready-to-use web components, that are deployed by default.

For more details, see Built-in Web Components.

Defining the widget size

The size of a WEBCOMPONENT widget can be controlled in grid-based or stack-based layout, based on several attributes such as SIZEPOLICY and STRETCH.

For more details about image sizing, see Controlling the web component layout.