Taglib documentation for tag mak:newForm#
Description#
Makes a form for creating a new object of the indicated type.
.
Attributes#
| Name | Required | Runtime expression | Description | Comments |
|---|---|---|---|---|
| type | true | false | Makumba type for record creation, or MQL label for subrecord creation
. |
Mandatory
.
|
| action (from mak:form) |
false | true | the response page of the form
. |
Mandatory if a <mak:action> is absent
.
|
| method (from mak:form) |
false | true | the HTTP method (get or post)
. |
Defaults to get
.
|
| name | false | true | in the action page, the created object will be available as an attribute with this name (technically as a request-scope attribute). It is available e.g. in JSTL EL as ${name}
. |
Defaults to __mak__edited__. If set, it is also used for the name of the html form (<form name="..." ...>)
.
|
| message (from mak:form) |
false | true | the message that is displayed in the response page upon success
. |
Defaults to "changes done".
.
|
| triggerEvent (from mak:form) |
false | true | Name of the event to be raised after successful AJAX submission of the form
. |
In case of a successful response, the event is fired.
.
|
| db (from mak:form) |
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.
. |
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 (from mak:form) |
false | true | Indicates whether validation 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 (from mak:form) |
false | true | Prints the given separator between the annotation and the input field.
. |
Also HTML can be used, e.g. printing an error icon.
.
|
| reloadFormOnError (from mak:form) |
false | true | Indicates whether the form page shall be reloaded on an error, or the specified form action page will be loaded directly.
. |
Values are true or false; defaults to false.
.
|
| clientSideValidation (from mak:form) |
false | true | Controls whether client side validation shall be used.
. |
Values are false (off), true (on submission) or live (while tpying).
.
|
| multipleSubmitErrorMsg (from mak:form) |
false | true | Enables multiple form submission prevention, and sets the given value as the error message.
. |
.
|
| target (from mak:form) |
false | true | Form-specific HTML tag attribute
(generic) |
The content is copied to the resulting <form...> tag. Careful with (escaping) quotes.
(generic)
|
| onReset (from mak:form) |
false | true | ||
| onSubmit (from mak:form) |
false | true | ||
| styleClass (from mak:form) |
false | true | Generic HTML tag attribute
. |
results in class="..."
.
|
| style (from mak:form) |
false | true | Generic HTML tag attribute
(generic) |
The content is copied to the resulting html tag. Careful with (escaping) quotes.
(generic)
|
| title (from mak:form) |
false | true | ||
| onClick (from mak:form) |
false | true | ||
| onDblClick (from mak:form) |
false | true | ||
| onKeyDown (from mak:form) |
false | true | ||
| onKeyUp (from mak:form) |
false | true | ||
| onKeyPress (from mak:form) |
false | true | ||
| onMouseDown (from mak:form) |
false | true | ||
| onMouseUp (from mak:form) |
false | true | ||
| onMouseMove (from mak:form) |
false | true | ||
| onMouseOut (from mak:form) |
false | true | ||
| onMouseOver (from mak:form) |
false | true |
See also#
mak:input, mak:form, mak:addForm, mak:editForm, mak:deleteLink, mak:delete
Examples#
<mak:newForm type="company.Employee" action="employeeList.jsp" method="post">
<mak:input name="name"/>
<mak:input name="surname"/>
<input type="submit" value="Create new employee">
</mak:newForm>