Standard Radio Button List Component

See Also

You can drag the Standard JavaServer Faces Radio Button List component  from the Palette to the Visual Designer to create a table initially containing three radio buttons in single row.

• This component is a JavaServer Faces reference implementation that cannot use themes. The Radio Button Group component in the Basic category of the Palette does support themes and provides other features that improve ease of use.
   
  

A Radiobutton List is a composite component: the enclosing component (radioButtonList) manages the style and behavior of the list itself, and the inside component (radioButtonListSelectItems) is used to bind to the actual items in the list. A third, related component named radioButtonListDefaultItems is created for each Radiobutton List component that you add to the page and contains an array of static default items for the list (item1, item2, item3). This last component is not one that you typically work with. You can see all these components in the Outline window after you add a Radiobutton List to your page.

A Radiobutton List renders as an HTML <table> containing <input style="radio"> in each cell. Each <input> is enclosed in a <label> to provide the label for each button.

After adding a Radiobutton List Component to a page, you can do a number of things with it:

• Select the component and drag it to another location on the page.
   
  
• Drag a table from the Servers window and drop it on the component, and then choose whether to fill the list with the table data or set the component up to have its selection driven by another component. For more information, see Binding a List Component to a Database.
   
  
• Select the component and edit its properties in the Radiobutton List property sheet. Some typical properties you might set are:
  • id. The name of the Radiobutton List component. In the JSP file, this name is the value of the component's id attribute. In the page bean, this property's value is the name of the HtmlSelectOneList object.
     
    
  • value. Actually, you do not usually set this property. The value property is not rendered on the screen, but is used when the form is submitted to send the currently selected list element. The list of radio buttons displayed in the component is controlled by the radioButtonListSelectItems part of the component, not by the value property. See the Bind List Items to Database selection's description below for a typical way to set the radioButtonListSelectItems part of the component.
     
    You might also right-click the radioButtonListSelectItems node in the Outline window and choose Property Bindings to bind its value property to a property of the session bean that populates the list. See the session bean description in About the Outline Window for more information.
     
    
  
   
  
• Right-click the component and choose one of the following pop-up menu items:
  • Edit Event Handler. Write code for one of the following event handlers.
    • validate. Opens the Java Editor with the cursor positioned in the component's validate method so you can insert code to validate the value of the component.
       
      
    • processValueChange. Opens the Java Editor with the cursor positioned in the component's processValueChange method so you can insert code that executes when the value of this component changes (for example, the user changes the value of another component that is controlling the selected radio button in this component).
       
      
    
     
    
  • Bind to Data. Bind the component's value property to an object or to a data provider, as described in Bind to Data Dialog Box.
     
    
  • Auto-submit on Change. Causes the form to be automatically submitted if the value of the component changes. Sets the component's JavaScript onclick property to common_timeoutSubmitForm(this.form, 'component-id');. At runtime, this code causes the form to be automatically submitted if the user changes the component value. Once the form is submitted, conversion and validation occur on the server and any value change listener methods execute, and then the page is redisplayed.
     
    A component configured to Auto-submit on Change can use virtual forms to limit the input fields that are processed when the form is submitted. If the auto-submit component is defined to submit a virtual form, only the participants in that virtual form will be processed when the auto-submit occurs.
     
    
  • Configure Virtual Forms. Enables you to add the component to a virtual form.
     
    
  • Property Bindings. Opens a dialog box that enables you to bind the properties of the component to other objects or properties that update this component's properties automatically.
     
    
  
   
  

See Also

Working With Components

Component Tasks: Quick Reference

Component Web Tutorials

Data Source Web Tutorials

About the Palette