mirror of
https://github.com/s00500/ESPUI.git
synced 2024-11-22 04:00:55 +00:00
Update documentation to explain vertical layout
Also explains how to label groups of sliders/switchers. Also makes a tiny tweak to the width of vertical sliders so they are the same width as switchers.
This commit is contained in:
parent
df0c6faa4d
commit
c12f97de48
23
README.md
23
README.md
@ -453,7 +453,7 @@ You can get quite creative with this.
|
|||||||
|
|
||||||
![Inline Styles](docs/inlinestyles.gif)
|
![Inline Styles](docs/inlinestyles.gif)
|
||||||
|
|
||||||
The **completeExample** example includes a range of examples that you can do with inline styles.
|
The [completeExample](examples/completeExample/completeExample.cpp) example includes a range of things that you can do with inline styles.
|
||||||
|
|
||||||
![More Inline Styles](docs/ui_inlinestyles2.png)
|
![More Inline Styles](docs/ui_inlinestyles2.png)
|
||||||
|
|
||||||
@ -483,9 +483,26 @@ is purely visual.
|
|||||||
Most controls can be grouped this way, but the result is not always visually pleasant. This works best with labels, sliders, switchers,
|
Most controls can be grouped this way, but the result is not always visually pleasant. This works best with labels, sliders, switchers,
|
||||||
and buttons.
|
and buttons.
|
||||||
|
|
||||||
![Other grouped elements](docs/ui_groupedbuttons2.png)
|
![Other grouped controls](docs/ui_groupedbuttons2.png)
|
||||||
|
|
||||||
If you group too many elements it might throw the layout of the rest of the UI out of line. Consider adding separators to correct this.
|
For sliders and switchers, you can also set the controls to be displayed vertically.
|
||||||
|
|
||||||
|
```
|
||||||
|
auto vertswitcher = ESPUI.addControl(Switcher, "Vertical Switcher", "0", Dark, tab1);
|
||||||
|
ESPUI.setVertical(vertswitcher);
|
||||||
|
```
|
||||||
|
|
||||||
|
This must be done before `ESPUI.begin()` is called. Vertical layouts are currently only supported for sliders and switchers, and it
|
||||||
|
is a purely visual change. Behaviour is identical. Mixing horizontal and vertical controls can result in some unpredictable layouts.
|
||||||
|
|
||||||
|
When you add multiple buttons to a single panel, the buttons have a title so they can be differentiated. For sliders and switchers this is
|
||||||
|
not the case. Therefore you might want to add additional labels so that the controls can be distinguished. There is not yet automatic
|
||||||
|
support for doing this, so the approach is to add labels that have been styled using [inline styles](#inline-styles). By doing this
|
||||||
|
you can acheieve effects such as this:
|
||||||
|
|
||||||
|
![Labelling grouped controls](docs/ui_groupedbuttons3.png)
|
||||||
|
|
||||||
|
The code to do this is in the [completeExample](examples/completeExample/completeExample.cpp) example.
|
||||||
|
|
||||||
### Wide controls
|
### Wide controls
|
||||||
|
|
||||||
|
@ -1142,7 +1142,7 @@ text {
|
|||||||
width: 150px;
|
width: 150px;
|
||||||
transform: rotate(270deg);
|
transform: rotate(270deg);
|
||||||
display: inline-block;
|
display: inline-block;
|
||||||
margin: 50px -45px 70px -45px;
|
margin: 50px -42px 70px -42px;
|
||||||
}
|
}
|
||||||
|
|
||||||
.vert-slider span {
|
.vert-slider span {
|
||||||
|
2
data/css/style.min.css
vendored
2
data/css/style.min.css
vendored
File diff suppressed because one or more lines are too long
BIN
docs/ui_groupedbuttons3.png
Normal file
BIN
docs/ui_groupedbuttons3.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 43 KiB |
File diff suppressed because one or more lines are too long
Loading…
Reference in New Issue
Block a user