https://github.com/kitware/trame-vuetify
trame-vuetify brings Vuetify UI Material Components into trame
https://github.com/kitware/trame-vuetify
trame trame-maintenance-program
Last synced: 11 days ago
JSON representation
trame-vuetify brings Vuetify UI Material Components into trame
- Host: GitHub
- URL: https://github.com/kitware/trame-vuetify
- Owner: Kitware
- License: mit
- Created: 2022-05-05T22:21:25.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2025-04-11T13:48:33.000Z (12 days ago)
- Last Synced: 2025-04-11T14:52:58.007Z (12 days ago)
- Topics: trame, trame-maintenance-program
- Language: Python
- Homepage:
- Size: 2.47 MB
- Stars: 10
- Watchers: 7
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.rst
- License: LICENSE
Awesome Lists containing this project
README
.. |pypi_download| image:: https://img.shields.io/pypi/dm/trame-vuetify
trame-vuetify: Material Design widgets |pypi_download|
===========================================================================
.. image:: https://github.com/Kitware/trame-vuetify/actions/workflows/test_and_release.yml/badge.svg
:target: https://github.com/Kitware/trame-vuetify/actions/workflows/test_and_release.yml
:alt: Test and Release
Trame-vuetify extend trame **widgets** and **ui** with all the beautiful Vuetify UI components.
Vuetify is a UI Library with beautifully handcrafted Material Components. No design skills required — everything you need to create amazing applications is at your fingertips.
This package is not supposed to be used by itself but rather should come as a dependency of **trame**.
For any specificity, please refer to `the trame documentation `_.
Installing
-----------------------------------------------------------
trame-vuetify can be installed with `pip `_:
.. code-block:: bash
pip install --upgrade trame-vuetify
Usage
-----------------------------------------------------------
The `Trame Tutorial `_ is the place to go to learn how to use the library and start building your own application.
The `API Reference `_ documentation provides API-level documentation.
The `Vuetify website `_ is very well made for exploring components and understanding components' parameters and controls, while a reference to our wrapper API is available `here `_.
The way trame translate Vue templates into plain Python code is by doing the following.
Material Design Widgets
```````````````````````````````````````````````````````````
First you need to import the `vuetify` module so you can instantiate the various Material Components like illustrated below. Moreover, in the documentation the component names use dashes as separators while in Python we use the Camelcase notation for the class name.
.. code-block:: python
from trame.widgets import vuetify
# Hello World
btn = vuetify.VBtn("Hello World")
Boolean attributes
```````````````````````````````````````````````````````````
Implicit attribute values must be made explicit in Python by assigning `True` to them.
.. code-block:: python
#
vuetify.VTextField(disabled=True)
Dash and colon separators
```````````````````````````````````````````````````````````
Any special characters (`-` and `:`) become `_` in Python.
.. code-block:: python
#
vuetify.VTextField(v_model=("myText",))
Events
```````````````````````````````````````````````````````````
Events in vue are prefixed with a `@` but in Python we declare them the same way we declare regular attributes.
.. code-block:: python
def runMethod():
pass
#
vuetify.VBtn(click=runMethod)
License
-----------------------------------------------------------
trame-vuetify is made available under the MIT License. For more details, see `LICENSE `_
This license has been chosen to match the one use by `Vuetify `_ which is instrumental for making that library possible.
Community
-----------------------------------------------------------
`Trame `_ | `Discussions `_ | `Issues `_ | `RoadMap `_ | `Contact Us `_
.. image:: https://zenodo.org/badge/410108340.svg
:target: https://zenodo.org/badge/latestdoi/410108340
Enjoying trame?
-----------------------------------------------------------
Share your experience `with a testimonial `_ or `with a brand approval `_.
JavaScript dependency
-----------------------------------------------------------
This Python package bundle the following Vuetify libraries. For ``client_type="vue2"``, it exposes ``[email protected]`` and for ``client_type="vue3"``, it exposes ``[email protected]``.
If you would like us to upgrade any of those dependencies, `please reach out `_.