Build Custom Widgets
1 Introduction
A Mendix custom widget is a part of the user interface in your Mendix app that enables functionality and interaction with the users of the app. A custom widget can alter the interface, data, and images of the app as well as the way the app works. These custom widgets bridge the gap between using standard Mendix components (for example, buttons and list views) and creating very specific components yourself.
Custom widget development can be difficult at the beginning. The resources below will help you start your widget development.
2 Prerequisites
In order to create widgets, you need a good understanding of how JavaScript works. These texts can help you get started:
3 Specific Widget Topics
The sections below describe the Mendix resources that can help you understand how widgets are built.
3.1 Introduction Videos
3.2 Dojo
Custom widgets are Dojo widgets. In order to understand how widgets are structured and what their lifecycle is, you need to know how Dojo widgets are built. You can consult this quick introduction:
For details on the widget lifecycle, reference this documentation:
3.3 Widget Scaffolding
In the past we created widgets using Brackets and a plugin. With the new JavaScript/Node.JS tools that have recently come out, we deprecated this way of creating widgets. The new way of creating widgets is done using Yeoman and a generator.
This information is covered in Expert Series: Kickstart Your Widget Development.
3.4 Interacting with Mendix Runtime
Widgets have the ability to get data from the Runtime, manipulate objects, show validations, and set references. This is done through the Client API. For the latest version of the this API, see Client API.
3.5 Configuring the Widget in Mendix
Mendix has a specific way of configuring your widget through the use of an XML file. For more information and an example, see WidgetName in the AppStoreWidgetBoilerplate repository.
For the full reference on writing a widget XML, see the Build Widgets with XML.
3.6 Boilerplate
The Yeoman widget generator ships two versions of a boilerplate created by Mendix. The source code for this boilerplate is available in the AppStoreWidgetBoilerplate repository.
4 Further Reading
This category of how-to’s presents in-depth information on how to build your own widgets. A few more tips are below.
4.1 Learn by Example
Most of the widgets in the Mendix Marketplace are open-source and available on GitHub. You can find the View on GitHub link on the right side of the Marketplace screen:
4.2 Learn by Doing
Using the widget generator, you get a test project. With the test project (or your own project), you can quickly start creating widgets.
By debugging your widgets, you will quickly learn where you make mistakes and how the widget lifecycle works.
4.3 Ask the Community
Within the Mendix community of developers, there are plenty of widget developers. The Mendix Community is the place to go to when you have questions.