makumba hackers: this page is generated, don't edit it! Instead edit the text in the included pages.

Taglib documentation for tag mak:searchField#

Description#

Enclosed inside a <mak:criterion>, generates an input for that criterion. This tag is based on the <mak:input /> tag, and provides additionally the following attributes:
.

Attributes#

Name Required Runtime expression Description Comments
role false false
Indicates whether this input is the input for the lower or upper range.
.
Only for range searches, values are 'rangeBegin' and 'rangeEnd'. Defaults to 'rangeBegin'.
.
value
(from mak:input)		 false false
MQL expression relative to enclosing query tags or a $attribute computed previously in the page (with <mak:value var=.../>, pageContext.setAttribute(...), or read by in the previous page by an <mak:input />)
.

.
id
(from mak:list)		 false false
Tag's identifier
.
Can be used to distinguish otherwise identical tags on a page (to avoid confusion by Makumba's JSP analyser)
.
dataType
(from mak:input)		 false false
The makumba type of the data (needed if there is no value, no default expression for the value, or no makumba type associated with an attribute)
.
Can be char, char[xx], int, date, text, ptr Type, set Type
.
default
(from mak:input)		 false true
FIXME
.

.
format
(from mak:input)		 false false
Format string, according to java.text.SimpleDateFormat Can only countain d, M, y, H, m, s formatting chars, and any kind of separators. Ex: 'the day' dd 'of the month' MMMM 'in the year' yyyy. Default is "dd MMMM yyyy"
.
Only for date.
.
type
(from mak:input)		 false false
HTML INPUT type to be used
  • "hidden" works for all fields
  • for char, type can be "text" or "password", default is "text"
  • default type for [set]intEnum, [set]charEnum, ptr and set is "select" (dropdown or scroll list depending on size). Alternative is "tickbox" (checkboxes or radio buttons). Can be forced to a specific type by using "radio" or "checkbox"
  • for set, type can be seteditor, which will create two multiple-select boxes (see an example).
  • for int, spinner creates a spinner input with increase/decrease buttons; if a validation definition defines a range for the field, select and radio will create select boxes and radio buttons.
  • date is split in 3 inputs, <fieldname>_0 (day), _1 (month), _2 (year), and likewise for time elements
  • for text, default is "textarea"; "file" will create file upload box, and will create supplementary attributes <fieldname>_filename, <fieldname>_contentType and <fieldname>_contentLength that have to be handled separately by the handler method
  • for file, a file upload box will automatically created, and handling of file name, content type and length will be done automatically.
.

.
forceInputStyle false false
Changes the style/type of the input as it would be normally computed for the data type.
.
Applicable for the following data types:
  • text: 'input' forces an <input> tag rather than a <textArea>
  • ptr: 'multiple' forces a multiple-select rather than a single-select, and check-boxes rather than radio-buttons
  • set: 'single' forces a single-select rather than a multiple-select, and radio-buttons rather than check-boxes.
.
calendarEditor
(from mak:input)		 false false
Whether to generate code for a calendar editor.
.
Only for date types. Defaults to true resp. the default value specified in the Makumba configuration.
.
calendarEditorLink
(from mak:input)		 false false
The formatting that appears on the link to the calendar date-chooser.
.
Only for date types. Defaults to <img border="0" src="_CONTEXT_PATH_/mak-tools/makumbaResources/image/calendar.gif">
.
nameVar
(from mak:input)		 false false
The name of the java variable in which to store the name of the HTML input. In multiple forms, there may be more HTML inputs generated by one mak:input, so a suffix is added by makumba to the name to generate unique names for each.
.

.
nullOption
(from mak:input)		 false false
A text that would be displayed as the "null option" in drop-down boxes, i.e. to add a null value to the other possible options. May be used to allow a ptr to be set to null, and/or require a deliberate action from the users to select a value, rather leaving the default (first) value selected.
.
Only for ptr and intEnum types
.
labelSeparator
(from mak:input)		 false true
The string that separates the tickbox (radio/check) from the label. Default is " " (space). The output will be < tick >< labelSeparator >< label >
.
Only for type="tickbox"
.
elementSeparator
(from mak:input)		 false true
The string that separates the different options. Default is " " (space). The output will be < [x] label >< elementSeparator >< [x] label >
.
Only for type="tickbox"
.
size
(from mak:input)		 false true
Size of the input control
.
Only for char, int (size of the textbox) and set, ptr (height of the select)
.
maxlength
(from mak:input)		 false true
Max length of a text control
.
Only for char and int. Defaults to makumba width of the char
.
rows
(from mak:input)		 false true
Number of textarea rows and columns
.
only for text
.
cols
(from mak:input)		 false true
Number of textarea rows and columns
.
only for text
.
accessKey
(from mak:input)		 false true
Input-specific HTML tag attribute
(generic)
The content is copied to the resulting <input...> tag. Careful with (escaping) quotes.
(generic)
disabled
(from mak:input)		 false true
onChange
(from mak:input)		 false true
onBlur
(from mak:input)		 false true
onFocus
(from mak:input)		 false true
onSelect
(from mak:input)		 false true
tabIndex
(from mak:input)		 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:searchForm, mak:resultList, mak:criterion, mak:matchMode

Examples#

<mak:searchForm in="company.Company" name="searchCompany">
    <mak:criterion fields="name"> 
        <mak:searchField />
    </mak:criterion>
    <mak:criterion fields="targetMarkets">
        <mak:searchField forceInputStyle="single" /> 
    </mak:criterion>  
</mak:searchForm>
.

Category Documentation

Add Comment
« This page was last updated on August 1 2010