Home

This Chapter
-Chapter 3: The HTML Tag Library
-The html Tag
-The base Tag
-The form Tag
-The text, password, hidden, textarea Tags
-The submit and cancel Tags
-The reset Tag
-The button Tag
-The checkbox Tag
-The multibox Tag
-The radio Tag
-The select Tag
-The option Tag
-The options Tag
-The optionsCollection Tag
-The link Tag
-The img Tag
-The rewrite Tag
-The frame Tag
-The image Tag
-The xhtml Tag
-Summary

Table of Contents
-Introduction
-Chapter 1: Model 2 and Struts
-Chapter 2: Input Validation with Action Forms
-Chapter 3: The HTML Tag Library
-Chapter 4: Input Validation and Data Conversion
-Chapter 5: The Validator Plugin
-Chapter 6: The Expression Language
-Chapter 7: JSTL
-Chapter 8: The Bean Tag Library
-Chapter 9: The Logic Tag Library
-Chapter 10: Struts-EL, Nested, selectLabel
-Chapter 11: Message Handling and Internationalization
-Chapter 12: The Tiles Framework
-Chapter 13: Securing Struts Applications
-Chapter 14: The Config Object
-Chapter 15: The Persistence Layer
-Chapter 16: Object Caching
-Chapter 17: File Upload and File Download
-Chapter 18: Paging and Sorting
-Chapter 19: Preventing Double Submits
-Chapter 20: Early HttpSession Invalidation
-Chapter 21: Decorating Request Objects
-Chapter 22: How Struts Works

Previous
Next

 

The checkbox Tag

The checkbox tag represents a check box that can be mapped to an action form’s property of type boolean or java.lang.Boolean. Table 3.9 lists the attributes for this tag.

Attribute Description Possible Value(s)
indexed Indicates whether the value assigned to the name attribute is indexed. true or false
name The scoped variable containing the property specified by the property attribute. If the name attribute is not present, the value of the name attribute of the enclosing form tag will be used. string
property* The property of the action form mapped to the enclosing form tag that will be associated with the rendered HTML input field, unless overridden by the value attribute. string
value A constant value that will become the value of the rendered check box. string

Table 3.9: The checkbox tag’s attributes

Here is an example of the checkbox tag.

<html:checkbox property="subscribe"/>

This is translated into the following input element.

<input type="checkbox" name="subscribe" value="on">

In this example, if the check box is selected when the containing form is submitted, a request parameter named subscribe with the value on is sent to the server. Upon receiving this request parameter, Struts sets the corresponding boolean property to true. If the check box is not selected, no request parameter named subscribe is sent, and the associated property remains false.

Previous
Next