Widgets
Widgets are no-code blocks that render your data as visual components — charts, tables, KPIs, forms, and more — without writing display code. You configure them through a settings panel instead of code, making them the building blocks of your data apps.
What is a Widget?
In MINEO, a widget is a special type of block that renders specific visual components or provides different functionality. For example you can use widgets to retrieve data from your data source and then display the output in tables and charts.
Widgets can execute Python code, but the output is not displayed. You can use a widget to execute code and then hide the code area so that it does not visually affect your data app.
Getting started
Creating a Widget
To create your first widget, you can click the 'Add Widget' button on your Notebook button bar.
Configuring a Widget: Basic
Now you have your widget as a block of your Notebook. The next step is configuring it. Every Widget has different configuration options depending on its feature. You can open the settings drawer clicking the 'Widget Properties' button in a block's toolbar.
In the settings drawer, you have all the different configuration settings of the Widget, grouped by categories, such as basic configuration, style, formatting, etc.
Configuring a Widget: Variable interpolation
Widget setting inputs can interpolate variables from your Python context. For example, you can fill the 'title' field of a Widget Title with $my_title , and when you execute it, the setting will be filled with whatever value my_title has from previously executed blocks.
my_title = 'Hello World!'
What's Next?
In the following sections, you will learn in detail how to use and configure each type of widget.
See also
- Chart — render your data as interactive charts.
- Table — display query results and datasets in a table.
- KPI — highlight a single key metric.
- Query — fetch data from a data source to feed your widgets.
- Selectors — let users filter and parameterise your data app.
- Notebooks — the workspace where widgets live.
📄️ Title
The Title widget is used to display any text in a particular style. It is often used as a visual title for your data app or to indicate different sections.
📄️ KPI
The KPI (Key Performance Indicator) widget is a simple widget that displays values arranged in a grid.
📄️ Table
The Table widget is one of the most complex and powerful widgets in MINEO. It is a "batteries included" widget,
📄️ Data Export
The Data Export widget allows you to export tabular data from your notebook to a spreadsheet file (CSV or Excel),
📄️ Button
The Button widget allows you to stop execution until the user clicks the button. This can be useful for creating interactive notebooks that require user input.
📄️ Chart
The Chart widget allows you to visualize your data using different types of customizable charts.
📄️ Download
The Download widget allows you to download a file directly from your notebook, offering the feature as a customizable button.
📄️ Upload
The Data Upload widget allows you to upload files from your local system to your notebook environment, offering the feature as a customizable button.
📄️ Camera Input
The Camera Input widget allows you to capture a picture from your webcam to your notebook. Useful for creating many image related apps.
📄️ Image
The Image widget is used to display an image from your project's file system.
📄️ Query
This widget allows you to run SQL queries directly within your data application. You can also interpolate values from the Python context into your queries, making it possible to customize your queries dynamically based on the context of your notebook.
📄️ Form for data sources
The Form widget enables you to incorporate user interactivity into your data app. This widget allows you to configure various inputs, and it will then generate an interactive form for users to employ in filtering the data.
📄️ Form for Defined Values
The Form widget allows you to filter and input data in your data app. By defining one or more Python variables or static values, you can render an interactive form for user input.