Skip to content

Button~

obj:btn

lv_btn

Property Value Default Description
toggle bool false When enabled, creates a toggle-on/toggle-off button. If false, creates a normal button
val int16 0 The value: 0 = untoggled, 1 = toggled
text string "" The text of the label
mode string expand The wrapping mode of long text labels.
expand Expand the object size to the text size
break Keep the object width, break the too long lines and expand the object height
dots Keep the size and write dots at the end if the text is too long
scroll Keep the size and roll the text back and forth
loop Keep the size and roll the text circularly
crop Keep the size and crop the text out of it
align string left Text alignment: left, center, right

Examples~

Similar to the text label, it's possible to set the color of characters in the text indvidually, just prefix the text to be re-colored with a #RRGGBB hexadecimal color code and a space, and close with a single hash # tag.

Example jsonl
1
2
{"page":1,"id":2,"obj":"btn","x":10,"y":40,"w":105,"h":90,"toggle":false,"text":"Normal Button","mode":"break","align":"center"}
{"page":1,"id":3,"obj":"btn","x":125,"y":40,"w":105,"h":90,"toggle":true,"text":"#FFD700 Toggle# Button","mode":"break","align":"center"}

Events~

Push Button~

Normal buttons (toggle=false) send touch events while they occur:

Short touch:

1
2
{"event":"down"}
{"event":"up"}

Long press:

1
2
3
4
5
{"event":"down"}
{"event":"long"}
{"event":"hold"}
{"event":"hold"}
{"event":"release"}

Toggle Button~

Toggle buttons (toggle=true) send out the old value in the down event and the new value in the up event when released:

Toggle ON:

1
2
{"event":"down","val":0}
{"event":"up","val":1}

Toggle OFF:

1
2
{"event":"down","val":1}
{"event":"up","val":0}


Last update: 2023-12-10