Skip to content

trame-vuetify brings Vuetify UI Material Components into trame

License

Notifications You must be signed in to change notification settings

Kitware/trame-vuetify

Repository files navigation

trame-vuetify: Material Design widgets for trame

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:

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.

from trame.widgets import vuetify

# <v-btn>Hello World</v-btn>
btn = vuetify.VBtn("Hello World")

Boolean attributes

Implicit attribute values must be made explicit in Python by assigning True to them.

# <v-text-field disabled />
vuetify.VTextField(disabled=True)

Dash and colon separators

Any special characters (- and :) become _ in Python.

# <v-text-field v-model="myText" />
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.

def runMethod():
    pass

# <v-btn @click="runMethod" />
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

Enjoying trame?

Share your experience with a testimonial or with a brand approval.