mirror of
https://github.com/s00500/ESPUI.git
synced 2024-12-22 14:20:51 +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)
|
||||
|
||||
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)
|
||||
|
||||
@ -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,
|
||||
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
|
||||
|
||||
|
@ -1142,7 +1142,7 @@ text {
|
||||
width: 150px;
|
||||
transform: rotate(270deg);
|
||||
display: inline-block;
|
||||
margin: 50px -45px 70px -45px;
|
||||
margin: 50px -42px 70px -42px;
|
||||
}
|
||||
|
||||
.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