Back

hasManyCheckBox()

Used as a shortcut to output the proper form elements for an association. Note: Pass any additional arguments like class, rel, and id, and the generated tag will also include those values as HTML attributes.

Name	Type	Required	Default	Description
objectName	string	Yes		Name of the variable containing the parent object to represent with this form field.
association	string	Yes		Name of the association set in the parent object to represent with this form field.
keys	string	Yes		Primary keys associated with this form field. Note that these keys should be listed in the order that they appear in the database table.
label	string	No		The label text to use in the form control.
labelPlacement	string	No		Whether to place the label before, after, or wrapped around the form control. Label text placement can be controlled using `aroundLeft` or `aroundRight`.
prepend	string	No		String to prepend to the form control. Useful to wrap the form control with HTML tags.
append	string	No		String to append to the form control. Useful to wrap the form control with HTML tags.
prependToLabel	string	No		String to prepend to the form control's label. Useful to wrap the form control with HTML tags.
appendToLabel	string	No		String to append to the form control's label. Useful to wrap the form control with HTML tags.
errorElement	string	No		HTML tag to wrap the form control with when the object contains errors.
errorClass	string	No		The `class` name of the HTML tag that wraps the form control when there are errors.
encode	any	No	true	When set to `true`, encodes tag content, attribute values, and URLs so that Cross Site Scripting (XSS) attacks can be prevented. Set to `attributes` to only encode attribute values and not tag content.

<!--- Show check boxes for associating authors with the current book --->
<cfloop query="authors">
    #hasManyCheckBox(
        label=authors.fullName,
        objectName="book",
        association="bookAuthors",
        keys="#book.key()#,#authors.id#"
    )#
</cfloop>