-
Notifications
You must be signed in to change notification settings - Fork 57
Documentation for group attribute of h:selectOneRadio needs improvement #2014
Description
The <h:selectOneRadio> tag was extended with the group attribute in an earlier version of Faces. Using the group attribute allows the developer to avoid having table elements in the markup.
The behaviour with the group attribute is really different from the behaviour without the group attribute. For example, using a f:selectItems inside a h:selectOneRadio with the group attribute renders only the first element. This caused a lot of confusion for me when I tried it out the group attribute. So I looked into the documentation at https://jakarta.ee/specifications/faces/4.0/vdldoc/h/selectoneradio and https://jakarta.ee/specifications/faces/4.0/renderkitdoc/HTML_BASIC/jakarta.faces.SelectOnejakarta.faces.Radio.html . The documentation does not make this behaviour adequately clear. Additionally, the VDL documentation does not have the group attribute in its attribute the list.
The documentation needs to be improved to allow a developer to understand the behaviour with the group attribute. Examples could also be helpful.