spring-form.tldIntroductionOne of the view technologies you can use with the Spring Framework
is Java Server Pages (JSPs). To help you implement views using Java Server Pages
the Spring Framework provides you with some tags for evaluating errors, setting
themes and outputting internationalized messages.Please note that the various tags generated by this form tag library
are compliant with the XHTML-1.0-Strict specification and attendant DTD.This appendix describes the spring-form.tld tag library.The checkbox tagRenders an HTML 'input' tag with type 'checkbox'.
AttributesAttributeRequired?Runtime Expression?DescriptionaccesskeyfalsetrueHTML Standard AttributecssClassfalsetrueEquivalent to "class" - HTML Optional AttributecssErrorClassfalsetrueEquivalent to "class" - HTML Optional Attribute. Used when the bound field has errors.cssStylefalsetrueEquivalent to "style" - HTML Optional AttributedirfalsetrueHTML Standard AttributedisabledfalsetrueHTML Optional Attribute. Setting the value of this attribute to 'true' (without the quotes) will disable the HTML element.htmlEscapefalsetrueEnable/disable HTML escaping of rendered values.idfalsetrueHTML Standard AttributelabelfalsetrueValue to be displayed as part of the taglangfalsetrueHTML Standard AttributeonblurfalsetrueHTML Event AttributeonchangefalsetrueHTML Event AttributeonclickfalsetrueHTML Event AttributeondblclickfalsetrueHTML Event AttributeonfocusfalsetrueHTML Event AttributeonkeydownfalsetrueHTML Event AttributeonkeypressfalsetrueHTML Event AttributeonkeyupfalsetrueHTML Event AttributeonmousedownfalsetrueHTML Event AttributeonmousemovefalsetrueHTML Event AttributeonmouseoutfalsetrueHTML Event AttributeonmouseoverfalsetrueHTML Event AttributeonmouseupfalsetrueHTML Event AttributepathtruetruePath to property for data bindingtabindexfalsetrueHTML Standard AttributetitlefalsetrueHTML Standard AttributevaluefalsetrueHTML Optional Attribute
The checkboxes tagRenders multiple HTML 'input' tags with type 'checkbox'.
AttributesAttributeRequired?Runtime Expression?DescriptionaccesskeyfalsetrueHTML Standard AttributecssClassfalsetrueEquivalent to "class" - HTML Optional AttributecssErrorClassfalsetrueEquivalent to "class" - HTML Optional Attribute. Used when the bound field has errors.cssStylefalsetrueEquivalent to "style" - HTML Optional AttributedelimiterfalsetrueDelimiter to use between each 'input' tag with type 'checkbox'. There is no delimiter by default.dirfalsetrueHTML Standard AttributedisabledfalsetrueHTML Optional Attribute. Setting the value of this attribute to 'true' (without the quotes) will disable the HTML element.elementfalsetrueSpecifies the HTML element that is used to enclose each 'input' tag with type 'checkbox'. Defaults to 'span'.htmlEscapefalsetrueEnable/disable HTML escaping of rendered values.idfalsetrueHTML Standard AttributeitemLabelfalsetrueValue to be displayed as part of the 'input' tags with type 'checkbox'itemstruetrueThe Collection, Map or array of objects used to generate the 'input' tags with type 'checkbox'itemValuefalsetrueName of the property mapped to 'value' attribute of the 'input' tags with type 'checkbox'langfalsetrueHTML Standard AttributeonblurfalsetrueHTML Event AttributeonchangefalsetrueHTML Event AttributeonclickfalsetrueHTML Event AttributeondblclickfalsetrueHTML Event AttributeonfocusfalsetrueHTML Event AttributeonkeydownfalsetrueHTML Event AttributeonkeypressfalsetrueHTML Event AttributeonkeyupfalsetrueHTML Event AttributeonmousedownfalsetrueHTML Event AttributeonmousemovefalsetrueHTML Event AttributeonmouseoutfalsetrueHTML Event AttributeonmouseoverfalsetrueHTML Event AttributeonmouseupfalsetrueHTML Event AttributepathtruetruePath to property for data bindingtabindexfalsetrueHTML Standard AttributetitlefalsetrueHTML Standard Attribute
The errors tagRenders field errors in an HTML 'span' tag.
AttributesAttributeRequired?Runtime Expression?DescriptioncssClassfalsetrueEquivalent to "class" - HTML Optional AttributecssStylefalsetrueEquivalent to "style" - HTML Optional AttributedelimiterfalsetrueDelimiter for displaying multiple error messages. Defaults to the br tag.dirfalsetrueHTML Standard AttributeelementfalsetrueSpecifies the HTML element that is used to render the enclosing errors.htmlEscapefalsetrueEnable/disable HTML escaping of rendered values.idfalsetrueHTML Standard AttributelangfalsetrueHTML Standard AttributeonclickfalsetrueHTML Event AttributeondblclickfalsetrueHTML Event AttributeonkeydownfalsetrueHTML Event AttributeonkeypressfalsetrueHTML Event AttributeonkeyupfalsetrueHTML Event AttributeonmousedownfalsetrueHTML Event AttributeonmousemovefalsetrueHTML Event AttributeonmouseoutfalsetrueHTML Event AttributeonmouseoverfalsetrueHTML Event AttributeonmouseupfalsetrueHTML Event AttributepathfalsetruePath to errors object for data bindingtabindexfalsetrueHTML Standard AttributetitlefalsetrueHTML Standard Attribute
The form tagRenders an HTML 'form' tag and exposes a binding path to inner tags for binding.
AttributesAttributeRequired?Runtime Expression?DescriptionacceptCharsetfalsetrueSpecifies the list of character encodings for input data that is accepted by the server processing this form. The value is a space- and/or comma-delimited list of charset values. The client must interpret this list as an exclusive-or list, i.e., the server is able to accept any single character encoding per entity received.actionfalsetrueHTML Required AttributecommandNamefalsetrueName of the model attribute under which the form object is exposed.
Defaults to 'command'.cssClassfalsetrueEquivalent to "class" - HTML Optional AttributecssStylefalsetrueEquivalent to "style" - HTML Optional AttributedirfalsetrueHTML Standard AttributeenctypefalsetrueHTML Optional AttributehtmlEscapefalsetrueEnable/disable HTML escaping of rendered values.idfalsetrueHTML Standard AttributelangfalsetrueHTML Standard AttributemethodfalsetrueHTML Optional AttributemodelAttributefalsetrueName of the model attribute under which the form object is exposed.
Defaults to 'command'.namefalsetrueHTML Standard Attribute - added for backwards compatibility casesonclickfalsetrueHTML Event AttributeondblclickfalsetrueHTML Event AttributeonkeydownfalsetrueHTML Event AttributeonkeypressfalsetrueHTML Event AttributeonkeyupfalsetrueHTML Event AttributeonmousedownfalsetrueHTML Event AttributeonmousemovefalsetrueHTML Event AttributeonmouseoutfalsetrueHTML Event AttributeonmouseoverfalsetrueHTML Event AttributeonmouseupfalsetrueHTML Event AttributeonresetfalsetrueHTML Event AttributeonsubmitfalsetrueHTML Event AttributetargetfalsetrueHTML Optional AttributetitlefalsetrueHTML Standard Attribute
The hidden tagRenders an HTML 'input' tag with type 'hidden' using the bound value.
AttributesAttributeRequired?Runtime Expression?DescriptionhtmlEscapefalsetrueEnable/disable HTML escaping of rendered values.idfalsetrueHTML Standard AttributepathtruetruePath to property for data binding
The input tagRenders an HTML 'input' tag with type 'text' using the bound value.
AttributesAttributeRequired?Runtime Expression?DescriptionaccesskeyfalsetrueHTML Standard AttributealtfalsetrueHTML Optional AttributeautocompletefalsetrueCommon Optional AttributecssClassfalsetrueEquivalent to "class" - HTML Optional AttributecssErrorClassfalsetrueEquivalent to "class" - HTML Optional Attribute. Used when the bound field has errors.cssStylefalsetrueEquivalent to "style" - HTML Optional AttributedirfalsetrueHTML Standard AttributedisabledfalsetrueHTML Optional Attribute. Setting the value of this attribute to 'true' (without the quotes) will disable the HTML element.htmlEscapefalsetrueEnable/disable HTML escaping of rendered values.idfalsetrueHTML Standard AttributelangfalsetrueHTML Standard AttributemaxlengthfalsetrueHTML Optional AttributeonblurfalsetrueHTML Event AttributeonchangefalsetrueHTML Event AttributeonclickfalsetrueHTML Event AttributeondblclickfalsetrueHTML Event AttributeonfocusfalsetrueHTML Event AttributeonkeydownfalsetrueHTML Event AttributeonkeypressfalsetrueHTML Event AttributeonkeyupfalsetrueHTML Event AttributeonmousedownfalsetrueHTML Event AttributeonmousemovefalsetrueHTML Event AttributeonmouseoutfalsetrueHTML Event AttributeonmouseoverfalsetrueHTML Event AttributeonmouseupfalsetrueHTML Event AttributeonselectfalsetrueHTML Event AttributepathtruetruePath to property for data bindingreadonlyfalsetrueHTML Optional Attribute. Setting the value of this attribute to 'true' (without the quotes) will make the HTML element readonly.sizefalsetrueHTML Optional AttributetabindexfalsetrueHTML Standard AttributetitlefalsetrueHTML Standard Attribute
The label tagRenders a form field label in an HTML 'label' tag.
AttributesAttributeRequired?Runtime Expression?DescriptioncssClassfalsetrueEquivalent to "class" - HTML Optional Attribute.cssErrorClassfalsetrueEquivalent to "class" - HTML Optional Attribute. Used only when errors are present.cssStylefalsetrueEquivalent to "style" - HTML Optional AttributedirfalsetrueHTML Standard AttributeforfalsetrueHTML Standard AttributehtmlEscapefalsetrueEnable/disable HTML escaping of rendered values.idfalsetrueHTML Standard AttributelangfalsetrueHTML Standard AttributeonclickfalsetrueHTML Event AttributeondblclickfalsetrueHTML Event AttributeonkeydownfalsetrueHTML Event AttributeonkeypressfalsetrueHTML Event AttributeonkeyupfalsetrueHTML Event AttributeonmousedownfalsetrueHTML Event AttributeonmousemovefalsetrueHTML Event AttributeonmouseoutfalsetrueHTML Event AttributeonmouseoverfalsetrueHTML Event AttributeonmouseupfalsetrueHTML Event AttributepathtruetruePath to errors object for data bindingtabindexfalsetrueHTML Standard AttributetitlefalsetrueHTML Standard Attribute
The option tagRenders a single HTML 'option'. Sets 'selected' as appropriate based on bound value.
AttributesAttributeRequired?Runtime Expression?DescriptioncssClassfalsetrueEquivalent to "class" - HTML Optional AttributecssErrorClassfalsetrueEquivalent to "class" - HTML Optional Attribute. Used when the bound field has errors.cssStylefalsetrueEquivalent to "style" - HTML Optional AttributedirfalsetrueHTML Standard AttributedisabledfalsetrueHTML Optional Attribute. Setting the value of this attribute to 'true' (without the quotes) will disable the HTML element.htmlEscapefalsetrueEnable/disable HTML escaping of rendered values.idfalsetrueHTML Standard AttributelabelfalsetrueHTML Optional AttributelangfalsetrueHTML Standard AttributeonclickfalsetrueHTML Event AttributeondblclickfalsetrueHTML Event AttributeonkeydownfalsetrueHTML Event AttributeonkeypressfalsetrueHTML Event AttributeonkeyupfalsetrueHTML Event AttributeonmousedownfalsetrueHTML Event AttributeonmousemovefalsetrueHTML Event AttributeonmouseoutfalsetrueHTML Event AttributeonmouseoverfalsetrueHTML Event AttributeonmouseupfalsetrueHTML Event AttributetabindexfalsetrueHTML Standard AttributetitlefalsetrueHTML Standard AttributevaluetruetrueHTML Optional Attribute
The options tagRenders a list of HTML 'option' tags. Sets 'selected' as appropriate based on bound value.
AttributesAttributeRequired?Runtime Expression?DescriptioncssClassfalsetrueEquivalent to "class" - HTML Optional AttributecssErrorClassfalsetrueEquivalent to "class" - HTML Optional Attribute. Used when the bound field has errors.cssStylefalsetrueEquivalent to "style" - HTML Optional AttributedirfalsetrueHTML Standard AttributedisabledfalsetrueHTML Optional Attribute. Setting the value of this attribute to 'true' (without the quotes) will disable the HTML element.htmlEscapefalsetrueEnable/disable HTML escaping of rendered values.idfalsetrueHTML Standard AttributeitemLabelfalsetrueName of the property mapped to the inner text of the 'option' tagitemstruetrueThe Collection, Map or array of objects used to generate the inner 'option' tagsitemValuefalsetrueName of the property mapped to 'value' attribute of the 'option' taglangfalsetrueHTML Standard AttributeonclickfalsetrueHTML Event AttributeondblclickfalsetrueHTML Event AttributeonkeydownfalsetrueHTML Event AttributeonkeypressfalsetrueHTML Event AttributeonkeyupfalsetrueHTML Event AttributeonmousedownfalsetrueHTML Event AttributeonmousemovefalsetrueHTML Event AttributeonmouseoutfalsetrueHTML Event AttributeonmouseoverfalsetrueHTML Event AttributeonmouseupfalsetrueHTML Event AttributetabindexfalsetrueHTML Standard AttributetitlefalsetrueHTML Standard Attribute
The password tagRenders an HTML 'input' tag with type 'password' using the bound value.
AttributesAttributeRequired?Runtime Expression?DescriptionaccesskeyfalsetrueHTML Standard AttributealtfalsetrueHTML Optional AttributeautocompletefalsetrueCommon Optional AttributecssClassfalsetrueEquivalent to "class" - HTML Optional AttributecssErrorClassfalsetrueEquivalent to "class" - HTML Optional Attribute. Used when the bound field has errors.cssStylefalsetrueEquivalent to "style" - HTML Optional AttributedirfalsetrueHTML Standard AttributedisabledfalsetrueHTML Optional Attribute. Setting the value of this attribute to 'true' (without the quotes) will disable the HTML element.htmlEscapefalsetrueEnable/disable HTML escaping of rendered values.idfalsetrueHTML Standard AttributelangfalsetrueHTML Standard AttributemaxlengthfalsetrueHTML Optional AttributeonblurfalsetrueHTML Event AttributeonchangefalsetrueHTML Event AttributeonclickfalsetrueHTML Event AttributeondblclickfalsetrueHTML Event AttributeonfocusfalsetrueHTML Event AttributeonkeydownfalsetrueHTML Event AttributeonkeypressfalsetrueHTML Event AttributeonkeyupfalsetrueHTML Event AttributeonmousedownfalsetrueHTML Event AttributeonmousemovefalsetrueHTML Event AttributeonmouseoutfalsetrueHTML Event AttributeonmouseoverfalsetrueHTML Event AttributeonmouseupfalsetrueHTML Event AttributeonselectfalsetrueHTML Event AttributepathtruetruePath to property for data bindingreadonlyfalsetrueHTML Optional Attribute. Setting the value of this attribute to 'true' (without the quotes) will make the HTML element readonly.showPasswordfalsetrueIs the password value to be shown? Defaults to false.sizefalsetrueHTML Optional AttributetabindexfalsetrueHTML Standard AttributetitlefalsetrueHTML Standard Attribute
The radiobutton tagRenders an HTML 'input' tag with type 'radio'.
AttributesAttributeRequired?Runtime Expression?DescriptionaccesskeyfalsetrueHTML Standard AttributecssClassfalsetrueEquivalent to "class" - HTML Optional AttributecssErrorClassfalsetrueEquivalent to "class" - HTML Optional Attribute. Used when the bound field has errors.cssStylefalsetrueEquivalent to "style" - HTML Optional AttributedirfalsetrueHTML Standard AttributedisabledfalsetrueHTML Optional Attribute. Setting the value of this attribute to 'true' (without the quotes) will disable the HTML element.htmlEscapefalsetrueEnable/disable HTML escaping of rendered values.idfalsetrueHTML Standard AttributelabelfalsetrueValue to be displayed as part of the taglangfalsetrueHTML Standard AttributeonblurfalsetrueHTML Event AttributeonchangefalsetrueHTML Event AttributeonclickfalsetrueHTML Event AttributeondblclickfalsetrueHTML Event AttributeonfocusfalsetrueHTML Event AttributeonkeydownfalsetrueHTML Event AttributeonkeypressfalsetrueHTML Event AttributeonkeyupfalsetrueHTML Event AttributeonmousedownfalsetrueHTML Event AttributeonmousemovefalsetrueHTML Event AttributeonmouseoutfalsetrueHTML Event AttributeonmouseoverfalsetrueHTML Event AttributeonmouseupfalsetrueHTML Event AttributepathtruetruePath to property for data bindingtabindexfalsetrueHTML Standard AttributetitlefalsetrueHTML Standard AttributevaluefalsetrueHTML Optional Attribute
The radiobuttons tagRenders multiple HTML 'input' tags with type 'radio'.
AttributesAttributeRequired?Runtime Expression?DescriptionaccesskeyfalsetrueHTML Standard AttributecssClassfalsetrueEquivalent to "class" - HTML Optional AttributecssErrorClassfalsetrueEquivalent to "class" - HTML Optional Attribute. Used when the bound field has errors.cssStylefalsetrueEquivalent to "style" - HTML Optional AttributedelimiterfalsetrueDelimiter to use between each 'input' tag with type 'radio'. There is no delimiter by default.dirfalsetrueHTML Standard AttributedisabledfalsetrueHTML Optional Attribute. Setting the value of this attribute to 'true' (without the quotes) will disable the HTML element.elementfalsetrueSpecifies the HTML element that is used to enclose each 'input' tag with type 'radio'. Defaults to 'span'.htmlEscapefalsetrueEnable/disable HTML escaping of rendered values.idfalsetrueHTML Standard AttributeitemLabelfalsetrueValue to be displayed as part of the 'input' tags with type 'radio'itemstruetrueThe Collection, Map or array of objects used to generate the 'input' tags with type 'radio'itemValuefalsetrueName of the property mapped to 'value' attribute of the 'input' tags with type 'radio'langfalsetrueHTML Standard AttributeonblurfalsetrueHTML Event AttributeonchangefalsetrueHTML Event AttributeonclickfalsetrueHTML Event AttributeondblclickfalsetrueHTML Event AttributeonfocusfalsetrueHTML Event AttributeonkeydownfalsetrueHTML Event AttributeonkeypressfalsetrueHTML Event AttributeonkeyupfalsetrueHTML Event AttributeonmousedownfalsetrueHTML Event AttributeonmousemovefalsetrueHTML Event AttributeonmouseoutfalsetrueHTML Event AttributeonmouseoverfalsetrueHTML Event AttributeonmouseupfalsetrueHTML Event AttributepathtruetruePath to property for data bindingtabindexfalsetrueHTML Standard AttributetitlefalsetrueHTML Standard Attribute
The select tagRenders an HTML 'select' element. Supports databinding to the selected option.
AttributesAttributeRequired?Runtime Expression?DescriptionaccesskeyfalsetrueHTML Standard AttributecssClassfalsetrueEquivalent to "class" - HTML Optional AttributecssErrorClassfalsetrueEquivalent to "class" - HTML Optional Attribute. Used when the bound field has errors.cssStylefalsetrueEquivalent to "style" - HTML Optional AttributedirfalsetrueHTML Standard AttributedisabledfalsetrueHTML Optional Attribute. Setting the value of this attribute to 'true' (without the quotes) will disable the HTML element.htmlEscapefalsetrueEnable/disable HTML escaping of rendered values.idfalsetrueHTML Standard AttributeitemLabelfalsetrueName of the property mapped to the inner text of the 'option' tagitemsfalsetrueThe Collection, Map or array of objects used to generate the inner 'option' tagsitemValuefalsetrueName of the property mapped to 'value' attribute of the 'option' taglangfalsetrueHTML Standard AttributemultiplefalsetrueHTML Optional AttributeonblurfalsetrueHTML Event AttributeonchangefalsetrueHTML Event AttributeonclickfalsetrueHTML Event AttributeondblclickfalsetrueHTML Event AttributeonfocusfalsetrueHTML Event AttributeonkeydownfalsetrueHTML Event AttributeonkeypressfalsetrueHTML Event AttributeonkeyupfalsetrueHTML Event AttributeonmousedownfalsetrueHTML Event AttributeonmousemovefalsetrueHTML Event AttributeonmouseoutfalsetrueHTML Event AttributeonmouseoverfalsetrueHTML Event AttributeonmouseupfalsetrueHTML Event AttributepathtruetruePath to property for data bindingsizefalsetrueHTML Optional AttributetabindexfalsetrueHTML Standard AttributetitlefalsetrueHTML Standard Attribute
The textarea tagRenders an HTML 'textarea'.
AttributesAttributeRequired?Runtime Expression?DescriptionaccesskeyfalsetrueHTML Standard AttributecolsfalsetrueHTML Required AttributecssClassfalsetrueEquivalent to "class" - HTML Optional AttributecssErrorClassfalsetrueEquivalent to "class" - HTML Optional Attribute. Used when the bound field has errors.cssStylefalsetrueEquivalent to "style" - HTML Optional AttributedirfalsetrueHTML Standard AttributedisabledfalsetrueHTML Optional Attribute. Setting the value of this attribute to 'true' (without the quotes) will disable the HTML element.htmlEscapefalsetrueEnable/disable HTML escaping of rendered values.idfalsetrueHTML Standard AttributelangfalsetrueHTML Standard AttributeonblurfalsetrueHTML Event AttributeonchangefalsetrueHTML Event AttributeonclickfalsetrueHTML Event AttributeondblclickfalsetrueHTML Event AttributeonfocusfalsetrueHTML Event AttributeonkeydownfalsetrueHTML Event AttributeonkeypressfalsetrueHTML Event AttributeonkeyupfalsetrueHTML Event AttributeonmousedownfalsetrueHTML Event AttributeonmousemovefalsetrueHTML Event AttributeonmouseoutfalsetrueHTML Event AttributeonmouseoverfalsetrueHTML Event AttributeonmouseupfalsetrueHTML Event AttributeonselectfalsetrueHTML Event AttributepathtruetruePath to property for data bindingreadonlyfalsetrueHTML Optional Attribute. Setting the value of this attribute to 'true' (without the quotes) will make the HTML element readonly.rowsfalsetrueHTML Required AttributetabindexfalsetrueHTML Standard AttributetitlefalsetrueHTML Standard Attribute