Visual Elements
Visual Elements are user interface objects displayed on a given page. They reflect some application data or give the page some structuring or layout information. Most visual elements allow users to interact with the page content.
There are two types of Visual Elements:
-
Controls typically represent user data that the user can interact with.
The generic controls are listed in the Generic Controls section. Some controls dedicated to scenario and data management are available in the Scenario Management controls section. -
Blocks are listed in the Block Elements section. They let you organize controls (or blocks) in pages to provide the best possible user experience.
If you are just starting with Taipy GUI, you may want to look at the introduction page. It provides a comprehensive understanding of the visual elements, their properties, and how to use them.
Generic controls¶
Generic controls can be used in all situations when a user interface is needed.
These controls are elements representing generic data.
Here, you can find common graphical controls such as push buttons and sliders, as well as more
advanced graphical controls such as selectors, tables, and charts.
Available in Taipy GUI, Taipy Community, and Enterprise editions
The controls listed in this section are provided in the
taipy-gui
Python package. These controls are
also present when taipy
is installed.
Here is the list of all available controls in Taipy:




Displays a value as a static text.




A control that can trigger a function when pressed.




A control that displays some text that can potentially be edited.




A kind of [`input`](input.md) that handles numbers.




Displays and allows the user to set a value within a range.




A series of toggle buttons that the user can select.




A control that can display and specify a formatted date, with or without time.




A control that can display and specify a range of dates or times.




Displays data sets in a chart or a group of charts.




Displays a data set as tabular data.




A control that allows for selecting items from a list of choices.




Allows downloading of a file content.




Allows uploading a file content.




A control that can display an image.




A control that provides a visualization for a specific metric.




A control that can show the progression of some operation.




Displays a label on a red-to-green scale at a specific position.




Shows a left-side menu.




A navigation bar control.




Displays a status or a list of statuses.




A control that lets users enter their username and password.




A control that provides the user interface for chatting.




A control that allows for selecting items from a hierarchical view of items.
Scenario and Data Management controls¶
Some controls are dedicated to Scenario Management. These controls let users select Entities and interact with them.
Available in Taipy Community and Enterprise editions
The controls listed in this section are available only if the
taipy
Python package is installed. These controls are
not present if only taipy-gui
is installed.
Here is the list of all the scenario management-related controls that are available in Taipy:




Select scenarios from the list of all scenario entities.




Displays and modify the definition of a scenario.




Displays the DAG of a scenario.




Displays a list of the Data Node entities that can be selected.




Displays and edits of a data node.




Select jobs from the list of all job entities.
Block elements¶
Blocks are visual elements that allow for grouping user interface elements.
Here is the list of all available block elements in Taipy: