| 4 | == Introduction == |
| 5 | |
| 6 | The S3GroupedOptionsWidget renders a SELECT element as table of radiobuttons/checkboxes: |
| 7 | |
| 8 | ||'''!MultipleOptionsWidget'''||'''S3GroupedOptionsWidget'''|| |
| 9 | ||[[Image(groupedopts3.png)]]||[[Image(groupedopts1.png)]]|| |
| 10 | |
| 11 | The widget can also automatically group options lexicographically (by first letter): |
| 12 | |
| 13 | ||'''!MultipleOptionsWidget'''||'''S3GroupedOptionsWidget'''|| |
| 14 | ||[[Image(groupedopts4.png)]]||[[Image(groupedopts2.png)]]|| |
| 15 | |
| 16 | The main use-case for S3GroupedOptionsWidget is filter forms where the user typically selects multiple options. However, the widget can also be used for single-option SELECTs - in this case the options would be rendered as radio buttons instead of checkboxes so the user can only select one option. |