extern/egroupware_official
1
0
Fork 0
mirror of https://github.com/EGroupware/egroupware.git synced 2024-12-14 02:30:56 +01:00
Code Issues Packages Projects Releases Wiki Activity

Some docs on disabled vs readonly vs hidden

Browse Source
This commit is contained in:
nathan 2024-12-12 11:07:57 -07:00
parent a1b6222c4b
commit bbd4a79452
1 changed files with 26 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
doc/etemplate2/pages/getting-started/widgets.md
View File

@ -21,4 +21,29 @@ If you just want to use existing widgets, you can put them in your .xet template
</overlay>
```
<img src="/assets/images/widgets_rendered_example.png" alt="Rendered example template">
<img src="/assets/images/widgets_rendered_example.png" alt="Rendered example template">
## Attributes
Widget behaviour is customised by setting attributes
### ID
// TODO, maybe some notes about content & namespaces.
### Disabled vs Readonly vs Hidden
Disabled widgets are fully shown, but in a way that indicates the value cannot be changed.
Readonly widgets are shown in a special way that displays a value, but is not interactive. Often we switch to a
different component for faster performance, such as a simple
label. It is impossible to change the value of a readonly widget.
Hidden widgets are not visible.
```html:preview
<et2-textbox label="Normal" value="Normal textbox" class="et2-label-fixed"></et2-textbox>
<et2-textbox label="Disabled" disabled value="Disabled textbox" class="et2-label-fixed"></et2-textbox>
<et2-textbox_ro label="Readonly" value="Readonly textbox" class="et2-label-fixed"></et2-textbox_ro>
<et2-textbox label="Hidden" hidden>Hidden textbox</et2-textbox>
```