CustomWidget
The CustomWidget widget is the slot where a user-defined widget injected from your app's native code (SDK) is rendered.
Use it when a screen is hard to express with standard widgets — build it in code and drop it in here.
This widget is locked on the Free plan. It's available on the Pro and Enterprise plans.
Definition and role
The CustomWidget widget creates a slot on the canvas for the user-defined widget specified in your app code. Each slot is identified by its widget id. Until the app code assigns a widget, the slot draws a default placeholder — a gray-bordered box with the text Custom Widget in the center.
- Category: Contents
- Default size (SizedBox):
100×100 - Display when no widget is assigned: a gray-bordered box with rounded corners, plus the text
Custom Widgetin the center
Features
| Feature | Description |
|---|---|
| Place a user-defined widget | Renders the widget specified in your app code in this slot on the canvas. |
| Default placeholder | Before a widget is assigned, the slot shows a gray-bordered box with the text Custom Widget. |
How to use
- Open the Contents category in the left widget palette.
- Drag and drop the CustomWidget item onto the canvas.
- Assign a widget to this slot in your app code — matched by widget id — and it renders in place of the gray placeholder.
Properties
The CustomWidget widget has no dedicated properties in the edit panel. What it displays is decided by the widget your app code assigns.
Notes and tips
Until your app code assigns a widget, the slot shows only a gray-bordered box with the text Custom Widget. To fill it with a real screen, assign a widget in app code.
Dropping it from the palette places it at the default size of 100 × 100. Adjust the size after placing it.
Learn more
For the full set of Widget Control members (Property, Method, Event) you can script on this widget, visit CustomWidget Widget Control.