ansys-solutions-dash-super-components 0.2.dev7

A collection of pre-assembled, high-level Dash UI components built on Dash Mantine Components for simulation web applications.

Overview

Super Components for Dash is a collection of pre-assembled, high-level UI components built on top of the Dash Mantine Components (DMC) library. The components implement common patterns in simulation web app UIs, reducing frontend development effort by packaging UI logic and layout conventions into smart building blocks.

Dash is a trademark of Plotly Technologies Inc. This project is not affiliated with, endorsed by, or sponsored by Plotly Technologies Inc.

Documentation and issues

For full documentation, including the getting started guide, user guide, and API reference, see the Super Components for Dash documentation. In the upper right corner of the documentation’s title bar, there is an option for switching from viewing the documentation for the latest stable release to viewing the documentation for the development version or previously released versions.

On the Super Components for Dash Issues page, you can create issues to report bugs and request new features.

Installation

The ansys-solutions-dash-super-components package supports Python 3.10 through 3.14 on Windows and Linux.

Install the latest release from PyPI with:

pip install ansys-solutions-dash-super-components

Quick start

Important

Super Components for Dash use the callback decorator and other utilities from dash_extensions.enrich. Your application must use dash_extensions.enrich.DashProxy instead of the standard dash.Dash. Using dash.Dash directly causes the internal callbacks of the components to fail.

The following minimal example shows how to add the DualInputRangeSlider component to a Dash application:

import dash_mantine_components as dmc
from dash import _dash_renderer
from dash_extensions.enrich import DashProxy, html
from ansys.solutions.dash_super_components import DualInputRangeSlider

# Required for Dash 2.x
_dash_renderer._set_react_version("18.2.0")

app = DashProxy(__name__)

app.layout = dmc.MantineProvider(
    children=[
        html.Div(
            [
                DualInputRangeSlider(
                    aio_id="example-slider",
                    min=0,
                    max=100,
                    value=[20, 80],
                )
            ],
            style={"padding": "40px"},
        )
    ]
)

if __name__ == "__main__":
    app.run(debug=True)

Run the example with python app.py and open http://127.0.0.1:8050 in your browser.

For detailed instructions on how to get started with Super Components for Dash, see the getting started guide in the documentation.

For more complex examples, see the showcase application in the repository.

Contributing

Contributions are welcome! See the contributing guide for developer installation instructions and guidelines on how to contribute code, documentation, and examples to this project.

License

This project is licensed under the Apache 2.0 License. For more information, see the LICENSE file.