Skip to content

Documentation for group attribute of h:selectOneRadio needs improvement #2014

@dnb-erik-brangs

Description

@dnb-erik-brangs

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions