Shared properties
Last updated
Last updated
Every component offers a specific set of properties, events and functions. These are used to modify the look-and-feel and behavior of each component for the particular use case in your app.
While every component type implies a different set of exposed features, there are certain properties that are shared among all components, regardless of the type. As general introduction to the component reference, this page introduces those shared properties first, so that they are not repeated in each reference page again.
Every component offers the following configuration options in the properties panel.
Property | Type | Default value | Behavior |
---|---|---|---|
There are currently no events that all components have in common. Read the reference page of each component to learn more about their events.
Every component exposes the following properties and functions as part of its JavaScript API:
Property / Function | Type | Behavior |
---|---|---|
Box shadow
Boolean
Component specific
When set to true
, the affected component is rendered with a surrounding box-shadow. It is enabled by default for some larger components that are usually stand-alone, like a Chart
, but disabled for all others. This property is situated in the Style
tab of the properties panel.
Prevent deletion
Boolean
false
Usually, an app editor can freely delete any component without warning, assuming that there is no active usage. For components that are crucial to your particular app (e.g. a Tabbed Container
that acts as app navigation) you might want to enforce confirmation before deletes. When set to true
, the affected component cannot be deleted without an explicit confirmation.
Visible
Boolean
true
When set to true
, the affected component will not be visible in the app for the end user. While editing the app you still see the component, for awareness of its existence and to access its configuration. It will however be rendered semi-transparently to highlight the invisibility setting.
componentName
string
Type of the component, e.g. button
or table
name
string
The name of the component as defined in the properties panel. This will always equal the variable name of the component in JavaScript code.
setVisible(value)
(value: boolean) => void
Sets the visibility of the affected component to the provided boolean value.
visible
boolean
Provides the current value of the "Visible" property, i.e. a boolean value whether the component is visible for the end user or not.