Gauge
SVG donut/gauge chart component.
Preview
Disk used
Arguments
gauge(value=72, max_value=100, label='Disk used')
Usage
views.py
python
from djust import LiveView
from djust.components import Gauge
class MyView(LiveView):
template_name = "my_template.html"
def mount(self, request, **kwargs):
self.component = Gauge(value=72, max_value=100, label='Disk used')my_template.html
django
{{ component }}Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| value | float | 0 | current value |
| max_value | float | 100 | maximum value |
| label | str | '' | text label below gauge |
| color | str | 'primary' | color variant (primary, success, warning, danger) |
| size | str | 'md' | sm, md, lg |
| show_value | bool | True | whether to show percentage text |
| custom_class | str | '' | — |
| **kwargs | — passed to `Component.__init__`: `name=` identifies the instance in the events it sends, `id=` sets `component.id`, and any other keyword is kept as state | — | — |
Source & styles
| File | Path | Notes |
|---|---|---|
| module | djust.components.components.gauge | Subclass it, or pass custom_class, to change how it renders. |
| css | djust_components/components.css | Defines 6 of this component's classes at line 867, 868, 869, 870, 875, 876. Override those rules, or the custom properties they read, in a stylesheet loaded after it. |