Skip to content

WidgetManifestProperties

Interface

Properties that declare the widget capability. Some properties are automatically generated on compilation, and some need to be set in the manifest.json .

Properties

PropertyTypeNotes
canConsumeDataActionboolean

Default value is false. If true, the widget can provide a data set to the data action.

canCreateMapViewboolean

Default value is false. If true, the widget will be shown in the MapWidgetSelector .

canCrossLayoutBoundaryboolean

Default value is false. By default, a widget is constrained in the layout. Setting this property to true will make the widget overflow out of the layout.

canGenerateMultipleOutputDataSourcesboolean

Default value is false. If true, the widget can generate multiple output data sources.

canProvideRepeatDataSourceboolean

Default value is false. If true, the widget can provide a repeat data source.

coverLayoutBackgroundboolean

Default value is false. By default, a widget does not have background and the background set in the layout style will take effect. If it is true, the background setting in the layout style will be hidden.

deactivateOtherWidgetsboolean

Default value is true.

defaultOffPanelboolean

This is the default value of the WidgetJson.offPanel. If true, the newly added widgets will have be off panel by default.

flipIconboolean

Default value is false. If true, flips the icon on RTL.

forbidOneByOneEffectboolean

Default value is false. If true, the layout widget can not have one by one animation.

hasBuilderSupportModuleboolean

This property is automatically set. If runtime/builder-support.tsx exists, this property is true.

hasConfigboolean

This property is automatically set. If config.json exists, this property is true.

hasConfigInSettingPageboolean

Default value is true. If false, the builder will not load the setting page. One use case of setting the value to false is when a widget supports inline editing, as it does not need to show the setting page even though it has config.

hasEmbeddedLayoutboolean

Default value is false. If true, the framework will create the layouts for the widget, see layouts property.

hasMainClassboolean

This property is automatically set. If runtime/widget.tsx exists, this property is true.

hasSettingPageboolean

This property is automatically set. If setting/setting.tsx exists, this property is true.

isWidgetControllerboolean

Default value is false. A widget controller widget is used to control (open/close) other widgets.

lockChildrenboolean

Default value is true. If true, the children layout items are constrained in the widget.

needActiveStateboolean

Default value is false.

needHiddenStateboolean

Default value is false.

notAutoLoadUsedFieldsDataboolean

Default value is false. Set this property to true, won't load the used fields of the widget.

notShareDynamicModulesboolean

By default, the widget will share dynamic modules (load by import()) with other widgets, which means these modules will be compiled into the widgets/chunks folder. If this property is true, the dynamic modules will be compiled into the chunks folder of the widget.

showDescriptionboolean

Default value is false. If true, the description of the widget will be shown in the widget list. To support i18n, please define this string key in the translations/default.ts: _widgetDescription .

supportAutoSizeboolean

Default value is true. If true, the height/width of the widget can be set to auto.

supportInlineEditingboolean

Default value is false. If true, an edit button will show when widget is selected.

supportRepeatboolean

Default value is false. If true, the widget can be put in a list.

useDragHandlerboolean

Default value is false. Will the builder provider a drag handler for this widget.

watchViewportVisibilityboolean

Default value is false. Set this property to true, the widget can use <ViewportVisibilityContext.Consumer> to get whether the widget is in the browser viewport.

canConsumeDataAction

optional
Interface Property
canConsumeDataAction: boolean

Default value is false. If true, the widget can provide a data set to the data action.

canCreateMapView

Interface Property
canCreateMapView: boolean

Default value is false. If true, the widget will be shown in the MapWidgetSelector .

canCrossLayoutBoundary

optional
Interface Property
canCrossLayoutBoundary: boolean

Default value is false. By default, a widget is constrained in the layout. Setting this property to true will make the widget overflow out of the layout.

canGenerateMultipleOutputDataSources

optional
Interface Property
canGenerateMultipleOutputDataSources: boolean

Default value is false. If true, the widget can generate multiple output data sources.

canProvideRepeatDataSource

optional
Interface Property
canProvideRepeatDataSource: boolean

Default value is false. If true, the widget can provide a repeat data source.

coverLayoutBackground

optional
Interface Property
coverLayoutBackground: boolean

Default value is false. By default, a widget does not have background and the background set in the layout style will take effect. If it is true, the background setting in the layout style will be hidden.

deactivateOtherWidgets

optional
Interface Property
deactivateOtherWidgets: boolean

Default value is true.

For map widget, we can set this as false to enable other widgets to interact with map. True, means when this widget is activated, all other widgets will be deactivated. False, means when this widget is activated, will not change other widget's state.

This means there may be more than one active widgets.

defaultOffPanel

optional
Interface Property
defaultOffPanel: boolean

This is the default value of the WidgetJson.offPanel. If true, the newly added widgets will have be off panel by default.

flipIcon

optional
Interface Property
flipIcon: boolean

Default value is false. If true, flips the icon on RTL.

forbidOneByOneEffect

Interface Property
forbidOneByOneEffect: boolean

Default value is false. If true, the layout widget can not have one by one animation.

hasBuilderSupportModule

Interface Property
hasBuilderSupportModule: boolean

This property is automatically set. If runtime/builder-support.tsx exists, this property is true.

hasConfig

Interface Property
hasConfig: boolean

This property is automatically set. If config.json exists, this property is true.

hasConfigInSettingPage

Interface Property
hasConfigInSettingPage: boolean

Default value is true. If false, the builder will not load the setting page. One use case of setting the value to false is when a widget supports inline editing, as it does not need to show the setting page even though it has config.

hasEmbeddedLayout

Interface Property
hasEmbeddedLayout: boolean

Default value is false. If true, the framework will create the layouts for the widget, see layouts property.

hasMainClass

Interface Property
hasMainClass: boolean

This property is automatically set. If runtime/widget.tsx exists, this property is true.

hasSettingPage

Interface Property
hasSettingPage: boolean

This property is automatically set. If setting/setting.tsx exists, this property is true.

isWidgetController

optional
Interface Property
isWidgetController: boolean

Default value is false. A widget controller widget is used to control (open/close) other widgets.

lockChildren

Interface Property
lockChildren: boolean

Default value is true. If true, the children layout items are constrained in the widget.

needActiveState

optional
Interface Property
needActiveState: boolean

Default value is false.

When user click a widget, we can activate the widget (change the widget state to active), but not all widget needs this active state. So, for performance reason, we do not activate a widget by default.

When this property is true, and when a widget is activated, we'll use deactivateOtherWidgets to check whether deactivate other widgets.

needHiddenState

optional
Interface Property
needHiddenState: boolean

Default value is false.

When a widget is put in the page/window/view/sidebar/accordion, the widget can be hidden. When a widget is scrolled out of view or is put in the screen group, we don't change the widget state to hidden. For performance reason, a widget does not get a state value when it's rendered. When this property is true, we change the widget state to hidden when it's layout container is hidden. When it's layout container is shown, we change the widget state to undefined.

For example, when this property is true and the widget is added to a view. When the view is hidden, the widget state will be changed to hidden. When the view is shown, the widget state will be changed to undefined.

notAutoLoadUsedFieldsData

optional
Interface Property
notAutoLoadUsedFieldsData: boolean

Default value is false. Set this property to true, won't load the used fields of the widget.

Some widgets use fields but do not use these fields for display or not use data source to load these fields. For example, table widget uses fields but doesn't use data source to load these fields, chart widget uses fields but doesn't use these fields for display (it for statistic). In this case, we do not need to load these fields. After enable client-side query, the more fields we load, the slower the interaction with the map will be.

notShareDynamicModules

optional
Interface Property
notShareDynamicModules: boolean

By default, the widget will share dynamic modules (load by import()) with other widgets, which means these modules will be compiled into the widgets/chunks folder. If this property is true, the dynamic modules will be compiled into the chunks folder of the widget.

showDescription

optional
Interface Property
showDescription: boolean

Default value is false. If true, the description of the widget will be shown in the widget list. To support i18n, please define this string key in the translations/default.ts: _widgetDescription .

supportAutoSize

Interface Property
supportAutoSize: boolean

Default value is true. If true, the height/width of the widget can be set to auto.

supportInlineEditing

Interface Property
supportInlineEditing: boolean

Default value is false. If true, an edit button will show when widget is selected.

supportRepeat

Interface Property
supportRepeat: boolean

Default value is false. If true, the widget can be put in a list.

useDragHandler

optional
Interface Property
useDragHandler: boolean

Default value is false. Will the builder provider a drag handler for this widget.

watchViewportVisibility

optional
Interface Property
watchViewportVisibility: boolean

Default value is false. Set this property to true, the widget can use <ViewportVisibilityContext.Consumer> to get whether the widget is in the browser viewport.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.