!!!Taglib documentation for tag mak:form

!!Description

[{InsertPage page=FormTagDescription}]

!!Attributes

%%(display:none) makumba hackers: DO NOT CHANGE THESE ATTRIBUTES HERE since your changes will be lost! You have to edit the taglib-documented.xml file and re-generate the taglib doc! %%

[{Table

||Name||Required||Request-time||Description||Comments 

|handler 
|false 
|false 
|the Java method that handles the response 
|Arguments: (Dictionary formFields, Attributes restOfArguments, Database db) Not mandatory. A form without handler will simply set attributes (as makumba objects) for the next page 

|action 
|false 
|true 
|the response page of the form 
|Mandatory if a <mak:action> is absent 

|method 
|false 
|true 
|the HTTP method (get or post) 
|Defaults to get 

|name 
|false 
|true 
|the name of the form 
|%%(color:red) DOCUMENT ME PLEASE! %% 

|message 
|false 
|true 
|the message that is displayed in the response page upon success 
|Fixed. Defaults to "changes done". 

|db 
|false 
|true 
|The makumba database to connect to. The format is Host_SQLEngineType_DatabaseName If not present, the default database is used. See database configuration and lookup. 
|Fixed, cannot contain attributes, for now. The default database is chosen if this argument is not set. Can only be set for top-level (root) query tags Can be a Rtexpr <%= ...%> 

|annotation 
|false 
|true 
|Indicates that validation whether errors should be shown in the form, or be displayed in the <mak:response/>. 
|Taken into account only if reloadFormOnError is not set to false. Values are none (displayed in <mak:response/>), before (before the input), after (after the input) or both (displayed both before and after the input). Defaults to none. 

|annotationSeparator 
|false 
|true 
|Fixed. Prints the given separator between the annotation and the input field. 
|Also HTML can be used, e.g. printing an error icon. 

|reloadFormOnError 
|false 
|true 
|Indicates whether the form page shall be reloaded on an error, or the specified form action page will be loaded directly. 
|Fixed. Values are true or false; defaults to false. 

|clientSideValidation 
|false 
|true 
|Controls whether client side validation shall be used. 
|Rtexpr. Values are false (off), true (on submission) or live (while tpying). 

|multipleSubmitErrorMsg 
|false 
|true 
|Enables multiple form submission prevention, and sets the given value as the error message. 
|Document me please 

|target 
|false 
|true 
|Form-specific HTML tag attribute (generic) 
|The content is copied to the resulting <form...> tag. Careful with (escaping) quotes. (generic) 

|onReset 
|false 
|true 
|^ 
|^ 

|onSubmit 
|false 
|true 
|^ 
|^ 

|styleClass 
|false 
|true 
|Generic HTML tag attribute 
|results in class="..." 

|style 
|false 
|true 
|Generic HTML tag attribute (generic) 
|The content is copied to the resulting html tag. Careful with (escaping) quotes. (generic) 

|title 
|false 
|true 
|^ 
|^ 

|onClick 
|false 
|true 
|^ 
|^ 

|onDblClick 
|false 
|true 
|^ 
|^ 

|onKeyDown 
|false 
|true 
|^ 
|^ 

|onKeyUp 
|false 
|true 
|^ 
|^ 

|onKeyPress 
|false 
|true 
|^ 
|^ 

|onMouseDown 
|false 
|true 
|^ 
|^ 

|onMouseUp 
|false 
|true 
|^ 
|^ 

|onMouseMove 
|false 
|true 
|^ 
|^ 

|onMouseOut 
|false 
|true 
|^ 
|^ 

|onMouseOver 
|false 
|true 
|^ 
|^ 


}]

!!See also

[mak:input|InputTag], [mak:newForm|NewFormTag], [mak:addForm|AddFormTag], [mak:editForm|EditFormTag], [mak:deleteLink|DeleteLinkTag], [mak:delete|DeleteTag]

!!Examples

[{InsertPage page=FormTagExample}]


%%(display:none;)[Category Documentation]%%