Drehregler
Stellt einen number-Datenpunkt per Drehknopf ein — Wert wird durch Ziehen auf dem Bogen verändert. Drei Zeigertypen, konfigurierbarer Winkelbereich und ein Endlos-Modus. Bedient wird nur der Knopf selbst — der freie Bereich daneben bleibt zum Scrollen.
Datenpunkt
| Feld | Pflicht | Typ | |
|---|---|---|---|
datapoint | ja | number | wird beim Loslassen geschrieben (auf Schritt gerundet) |
Layouts
Default
Dünne Fortschritts-Spur mit Skalenstrichen, Linien- oder Pfeil-Zeiger auf dem Knopf-Körper.
Scale (knob-scale)
Dicker äußerer Bogen mit Zahlen-Labels und Zeiger an der Bogenspitze.
Endless (knob-endless)
Voller 3D-Kreisknopf mit Tick-Ring; relatives Ziehen ohne festen Anschlag — der Wert läuft endlos weiter.
Custom
Drehknopf in einer Zellenmatrix frei platzieren — der Stil wird über dialStyle (bogen · skala · endless) gewählt; siehe Custom-Layout.
Einstellungen
Alle Optionen werden im Editor unter Widget bearbeiten gesetzt.
Anzeige
| Option | Standard | |
|---|---|---|
showTitle | true | Titel anzeigen |
showIcon | true | Icon anzeigen |
icon | Gauge | Lucide-Icon |
iconSize | 18 | px |
titleAlign | left | left · center · right |
showValue | true | Wert in der Knopfmitte anzeigen |
showMinMax | false | Min/Max-Labels (Default-Layout) |
Wert
| Option | Standard | |
|---|---|---|
minValue | 0 | Skala-Minimum |
maxValue | 100 | Skala-Maximum |
step | 1 | Schrittweite beim Schreiben |
unit | — | Einheit hinter dem Wert |
decimals | globale Vorgabe | Nachkommastellen |
readOnly | false | Anzeige ohne Bedienung |
Umrechnung
Rechnet zwischen der Einheit des Datenpunkts und der Einheit um, in der bedient wird — in beide Richtungen: gelesen wird Wert × Faktor + Offset, geschrieben (Eingabe − Offset) ÷ Faktor. minValue, maxValue, step und unit gelten dann in der umgerechneten Einheit, der Datenpunkt behält seine eigene.
| Option | Standard | |
|---|---|---|
valueFactor | 1 | Multiplikator |
valueOffset | 0 | Summand |
Vorlagen im Dialog über den Knopf ƒ neben dem Datenpunkt: Sekunden → Minuten/Stunden, Millisekunden → Sekunden, Wh → kWh, W → kW, Bytes → KB/MB/GB, 0..1 → Prozent, °C → °F — oder Eigene… für Faktor und Offset von Hand.
Zeiger & Bogen
| Option | Standard | |
|---|---|---|
pointerStyle | line | line · circle · arrow |
color | --slider-fill (Endlos #4a4a4a) | Farbe von Bogen/Zeiger |
startAngle | 135 | Startwinkel in Grad (Endlos fest 126) |
endAngle | 405 | Endwinkel in Grad (Endlos fest 486) |
labelCount | 11 (Endlos 10) | Anzahl beschrifteter Ticks (Scale/Endlos) |
Optik
| Option | Standard | |
|---|---|---|
showRing | true | äußerer Metall-Ring (nur Default/Scale) |
showBackground | true | grauer Hintergrund-Disc (nur Default/Scale) |
dialStyle | bogen | Knopf-Stil im Custom-Layout: bogen · skala · endless |