Overview   Library    Tag    Help 
 FRAMES   NO FRAMES 

dbforms
Tag select

This tag renders a html SELECT element including embedded OPTION elements.

Example: 
					
						select tag, may contain nested "DbData"-Tags (OR
						"dboption" tags, which are not implemented yet)
						
						examples for DbData-Tags are tableData,
						queryData, staticData
					
					
						Example:
						
					
					
						<!We want to display a drop down list with
						data from the Cities table,
						
						use the city_reference value for the default
						list selection.
						
						Added a blank entry as default selection -->
						
						<db:select
						fieldName="city_reference"
						customEntry="001,,true">
						
						<db:queryData
						
						name="aQuery"
						
						query="Select city_id, city_name,
						city_state from Cities"/>
						
						</db:select>
					
					
						info
						
							
								"dboption"- tags are expected for the
								next release

Tag Information
Tag Classorg.dbforms.taglib.DbSelectTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
idfalsetruejava.lang.String Identification which can be used to 'pinpoint' dbForms fields for use in JavaScript methods. Note: Not supported by all browser! Example: <db:select fieldName="FIELD3" id="mySelect"></db:select>
fieldNametruetruejava.lang.String name of the field this tag references to
sizefalsetruejava.lang.String how many rows should the select box have
selectedIndexfalsetruejava.lang.StringNo Description
accessKeyfalsetruejava.lang.String The keyboard character used to move focus immediately to thiselement.
readOnlyfalsetruejava.lang.String Rendering of read-only html widgets WARNING: This is not terribly secure as it becomes editable if javascript is disabled in the browser. A More secure option is not placing an update button on your form.
patternfalsetruejava.lang.String When dealing with numeric or date/time values, you could use the Java API to format the output of the text field expressions yourself using the format attribute. But there is a more convenient way to do it: by using the pattern attribute. Useful in select if you have a 4 digit lookup value and want to avoid it being reformatted with the default locale as #,###. Use pattern="#" to avoid this.
customEntryfalsetruejava.lang.String Allows the possibility of adding an entry in the select list which is independent of data retrieved via tableData, queryData or staticData. Arguments to this tag are as follows: Key,Description,boolean (default selection?)
ifEmptyItemfalsetruejava.lang.String Item to be used if there is no embedded data Arguments to this tag are as follows: Key,Description
ifEmptyDontDrawfalsetruejava.lang.String Do not draw the Select box if there is no data
onBlurfalsetruejava.lang.String JavaScript event handler executed when this element loses inputfocus.
onChangefalsetruejava.lang.String JavaScript event handler executed when this element loses inputfocus and its value has changed.
onClickfalsetruejava.lang.String JavaScript event handler executed when this element receives amouse click.
onDblClickfalsetruejava.lang.String JavaScript event handler executed when this element receives amouse double click.
onFocusfalsetruejava.lang.String JavaScript event handler executed when this element receives inputfocus.
onKeyDownfalsetruejava.lang.String JavaScript event handler executed when this element has focus and akey is depressed.
onKeyPressfalsetruejava.lang.String JavaScript event handler executed when this element has focus and akey is depressed and released.
onKeyUpfalsetruejava.lang.String JavaScript event handler executed when this element has focus and akey is released.
onMouseDownfalsetruejava.lang.String JavaScript event handler executed when this element is under the mousepointer and a mouse button is depressed.
onMouseMovefalsetruejava.lang.String JavaScript event handler executed when this element is under themouse pointer and the pointer is moved.
onMouseOutfalsetruejava.lang.String JavaScript event handler executed when this element was under themouse pointer but the pointer was moved outside the element.
onMouseOverfalsetruejava.lang.String JavaScript event handler executed when this element was not underthe mouse pointer but the pointer is moved inside the element.
onMouseUpfalsetruejava.lang.String JavaScript event handler executed when this element is under themouse pointer and a mouse button is released.
onSelectfalsetruejava.lang.String JavaScipt event hanlder executed when the user selects an item
stylefalsetruejava.lang.String CSS styles to be applied to this HTML element.
styleClassfalsetruejava.lang.String CSS stylesheet class to be applied to this HTML element.
readOnlyStyleClassfalsetruejava.lang.String CSS stylesheet class to be applied to this HTML element (read-only mode).
titlefalsetruejava.lang.String this defines the "title" attribute for the HTML4 tag.
tabIndexfalsetruejava.lang.String The tab order (ascending positive integers) for this element.

Variables
No Variables Defined.

 Overview   Library    Tag    Help 
 FRAMES   NO FRAMES 
Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.