com.bea.wlw.netui.tags.html
Class TextBox

java.lang.Object
  javax.servlet.jsp.tagext.TagSupport
      javax.servlet.jsp.tagext.BodyTagSupport
          com.bea.wlw.netui.tags.AbstractBaseTag
              com.bea.wlw.netui.tags.DataSourceTag
                  com.bea.wlw.netui.tags.DefaultableDataSourceTag
                      com.bea.wlw.netui.tags.html.TextBox

All Implemented Interfaces:

Formattable, HtmlConstants, IAttributeConsumer, Serializable, javax.servlet.jsp.tagext.BodyTag, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.Tag

public class TextBox
extends DefaultableDataSourceTag
implements Formattable, IAttributeConsumer

Renders a databound TextBox with the given attributes.

Attribute Descriptions
Attribute	Required	Runtime Expression Evaluation	Data Bindable
accessKey	No	No	No
	Define the keyboard navigation key for the element.
alt	No	No	Read Only
	Define the alt attribute of the <Input> element.
dataSource	Yes	No	Read / Write
	The name of a form bean property or an expression that contains the TextBox state.
defaultValue	No	No	Read Only
	A literal value or an expression that is used to set the TextBox's initial state. The default value is applied only if the dataSource returns null.
disabled	No	No	Read Only
	A boolean value which if true will cause the textBox to be disabled.
maxLength	No	No	Read Only
	The maximum number of characters in the TextBox.
password	No	No	No
	A boolean specifying whether the password characters that the user enters into the textBox will be disguised in the browser.
readOnly	No	No	No
	A boolean specifying whether the TextBox is read-only.
size	No	No	Read Only
	The visible number of characters in the TextBox.
tagId	No	No	No
	The ID of this textbox used by the enclosing html tag to get the tag's name, for JavaScript and focus purposes.

See Also:

Serialized Form

Example:

In this sample, a <netui:textBox> reads from and writes to the Form Bean's firstname property. If the submitted text is NULL, the default value is specified by the Page Flow's firstName property.

     <netui:textBox dataSource="{actionForm.firstName}"
           defaultValue="{pageFlow.defaultFirstName}"
           size="20" />

Sample Code

[BEA_HOME]/weblogic81/samples/workshop/SamplesApp/WebApp/tagSamples/textBox/

Beadoc.see:

<netui:textBox> Sample

Beadoc.tagdescription:

Renders an HTML <input type="text"> tag.

Field Summary

Fields inherited from class com.bea.wlw.netui.tags.AbstractBaseTag

ATTR_GENERAL, ATTR_GENERAL_EXPRESSION, ATTR_JAVASCRIPT, ATTR_STYLE, JAVASCRIPT_STATUS, NETUI_UNIQUE_CNT

Fields inherited from class javax.servlet.jsp.tagext.BodyTagSupport

bodyContent

Fields inherited from class javax.servlet.jsp.tagext.TagSupport

id, pageContext

Fields inherited from interface com.bea.wlw.netui.tags.html.HtmlConstants

ACCEPT, ACCESSKEY, ACTION, ALIGN, ALINK, ALT, ANCHOR, BACKGROUND, BASE, BGCOLOR, BODY, BORDER, BR, CAPTION, CELLPADDING, CELLSPACING, CHAR, CHAROFF, CHARSET, CHECKED, CLASS, COLS, COORDS, DIR, DISABLED, DIV, ENCTYPE, FOR, FORM, FORM_GET, FORM_POST, FRAME, HEIGHT, HREF, HREFLANG, HSPACE, HTML, ID, IMAGE, INPUT, INPUT_BUTTON, INPUT_CHECKBOX, INPUT_FILE, INPUT_HIDDEN, INPUT_IMAGE, INPUT_PASSWORD, INPUT_RADIO, INPUT_RESET, INPUT_SUBMIT, INPUT_TEXT, ISMAP, LABEL, LANG, LINK, LONGDESC, MAXLENGTH, METHOD, NAME, ONBLUR, ONCHANGE, ONCLICK, ONDBLCLICK, ONFOCUS, ONKEYDOWN, ONKEYPRESS, ONKEYUP, ONLOAD, ONMOUSEDOWN, ONMOUSEMOVE, ONMOUSEOUT, ONMOUSEOVER, ONMOUSEUP, ONRESET, ONSELECT, ONSUBMIT, ONUNLOAD, OPTION, READONLY, REL, REV, ROWS, RULES, SELECT, SHAPE, SIZE, SPAN, SRC, STYLE, SUMMARY, TABINDEX, TABLE, TARGET, TD, TEXT, TEXTAREA, TITLE, TR, TYPE, USEMAP, VALIGN, VALUE, VLINK, VSPACE, WIDTH

Fields inherited from interface javax.servlet.jsp.tagext.BodyTag

EVAL_BODY_BUFFERED, EVAL_BODY_TAG

Fields inherited from interface javax.servlet.jsp.tagext.IterationTag

EVAL_BODY_AGAIN

Fields inherited from interface javax.servlet.jsp.tagext.Tag

EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE

Constructor Summary

TextBox()

Method Summary

void	addFormatter(FormatTag.Formatter formatter) Adds a FormatTag.Formatter to the TextBox's set of formatters
int	doEndTag() Render the TextBox.
int	doStartTag() Prepare the TextBox's formatters.
protected Object	evaluateDefaultValue()
protected String	formatText(Object text)
String	getAccessKey() Gets the accessKey attribute value.
String	getAlt() Gets the alt attribute on the generate <input tag.
String	getDisabled() Gets if this TextBox is disabled or not.
String	getMaxlength() Gets the maximum length (in characters) of the TextBox.
String	getOnBlur() Gets the onBlur javascript event.
String	getOnChange() Gets the onChange javascript event.
String	getOnClick() Gets the onClick javascript event.
String	getOnDblClick() Gets the onDblClick javascript event.
String	getOnFocus() Gets the onFocus javascript event.
String	getOnKeyDown() Gets the onKeyDown javascript event.
String	getOnKeyPress() Gets the onKeyPress javascript event.
String	getOnKeyUp() Gets the onKeyUp javascript event.
String	getOnMouseDown() Gets the onMouseDown javascript event.
String	getOnMouseMove() Gets the onMouseMove javascript event.
String	getOnMouseOut() Gets the onMouseOut javascript event.
String	getOnMouseOver() Gets the onMouseOver javascript event.
String	getOnMouseUp() Gets the onMouseUp javascript event.
String	getOnSelect() Gets the onSelect javascript event.
boolean	getPassword() Gets the password state (true means this is a password field).
boolean	getReadonly() Gets if this TextBox is read-only.
String	getSize() Gets the size (in characters) of the TextBox.
String	getStyle() Gets the style of the rendered html tag.
String	getStyleClass() Gets the style class of the rendered html tag.
String	getTabindex() Gets the tabIndex of the rendered html tag.
String	getTagId() Return the ID of the textbox.
String	getTagName() Return the name of the Tag.
protected void	localRelease() Release any acquired resources.
void	setAccessKey(String accessKey) Sets the accessKey attribute value.
void	setAlt(String alt) Sets the alt attribute value.
void	setAttribute(String name, String value) Set an attribute value.
void	setDisabled(String disabled) Set if this TexBox is disabled or not.
void	setMaxlength(String maxlength) Set the maximum length (in characters) of the TextBox.
void	setOnBlur(String onblur) Sets the onBlur javascript event.
void	setOnChange(String onchange) Sets the onChange javascript event.
void	setOnClick(String onclick) Sets the onClick javascript event.
void	setOnDblClick(String ondblclick) Sets the onDblClick javascript event.
void	setOnFocus(String onfocus) Sets the onFocus javascript event.
void	setOnKeyDown(String onkeydown) Sets the onKeyDown javascript event.
void	setOnKeyPress(String onkeypress) Sets the onKeyPress javascript event.
void	setOnKeyUp(String onkeyup) Sets the onKeyUp javascript event.
void	setOnMouseDown(String onmousedown) Sets the onMouseDown javascript event.
void	setOnMouseMove(String onmousemove) Sets the onMouseMove javascript event.
void	setOnMouseOut(String onmouseout) Sets the onMouseOut javascript event.
void	setOnMouseOver(String onmouseover) Sets the onMouseOver javascript event.
void	setOnMouseUp(String onmouseup) Sets the onMouseUp javascript event.
void	setOnSelect(String onselect) Sets the onSelect javascript event.
void	setPassword(boolean password) Set the password state (true means this is a password field).
void	setReadonly(boolean readonly) Set if this TextBox is read-only.
void	setSize(String size) Set the size (in characters) of the TextBox.
void	setStyle(String style) Sets the style of the rendered html tag.
void	setStyleClass(String styleClass) Sets the style class of the rendered html tag.
void	setTabindex(String tabindex) Sets the tabIndex of the rendered html tag.
void	setTagId(String tagId) Set the ID of the textbox.

Methods inherited from class com.bea.wlw.netui.tags.DefaultableDataSourceTag

getDefaultValue, setDefaultValue

Methods inherited from class com.bea.wlw.netui.tags.DataSourceTag

addNamingInterceptor, doNaming, evaluateDataSource, getDataSource, qualifyAttribute, removeNamingInterceptor, setDataSource

Methods inherited from class com.bea.wlw.netui.tags.AbstractBaseTag

addTagIdMapping, containsExpression, evaluateAttributeToString, evaluateExpression, filter, filter, formatErrorString, formatString, getAttribute, getErrorsReport, getExpressionEvaluator, getJavaScriptUtils, getNearestForm, getNextId, getQualifiedBundleName, getScriptReporter, getUserLocale, hasErrors, isExpression, prepForRendering, registerAttribute, registerError, registerTagError, release, removeAttribute, renderAttribute, renderAttributes, reportErrors, rewriteName, setPageContext, updateExpression, write

Methods inherited from class javax.servlet.jsp.tagext.BodyTagSupport

doAfterBody, doInitBody, getBodyContent, getPreviousOut, setBodyContent

Methods inherited from class javax.servlet.jsp.tagext.TagSupport

findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setParent, setValue

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.servlet.jsp.tagext.Tag

getParent, setParent

Constructor Detail

TextBox

public TextBox()

Method Detail

getTagName

public String getTagName()

Return the name of the Tag.

Specified by:

getTagName in class AbstractBaseTag

setAttribute

public void setAttribute(String name,
                         String value)
                  throws javax.servlet.jsp.JspException

Set an attribute value. The name represents the name of the attribute. The value represents the value and may contain a netui expression. This method may result in errors being generated. This requires that the tag buffer its body and write attributes in the end tag. For the textarea tag it is not legal to set the id or name attributes with this method.

Specified by:

setAttribute in interface IAttributeConsumer

Parameters:

name - The name of the attribute. This value may not be null or the empty string.

value - The value of the attribute. This may contain a netui expression.

Throws:

javax.servlet.jsp.JspException - A JspException may be thrown if there is an error setting the attribute.

evaluateDefaultValue

protected Object evaluateDefaultValue()

Overrides:

evaluateDefaultValue in class DefaultableDataSourceTag

Exclude:

getMaxlength

public String getMaxlength()

Gets the maximum length (in characters) of the TextBox.

Returns:

the max length

setMaxlength

public void setMaxlength(String maxlength)

Set the maximum length (in characters) of the TextBox.

Parameters:

maxlength - - the max length

Beadoc.attributedescription:

Integer. The maximum number of character that can be entered in the rendered <input> element.

Beadoc.attributesyntaxvalue:

integer_maxLength

Beadoc.databindable:

Read Only

getPassword

public boolean getPassword()

Gets the password state (true means this is a password field).

Returns:

the password state

setPassword

public void setPassword(boolean password)

Set the password state (true means this is a password field).

Parameters:

password - - the password state

Beadoc.attributedescription:

Boolean. Determines whether the password characters that the user enters into the <input> element will be disguised in the browser.

Beadoc.attributesyntaxvalue:

boolean_password

Beadoc.databindable:

false

getDisabled

public String getDisabled()

Gets if this TextBox is disabled or not.

Returns:

the disabled state (true or false)

setDisabled

public void setDisabled(String disabled)

Set if this TexBox is disabled or not.

Parameters:

disabled - - true or false

Beadoc.attributedescription:

Boolean. Determines if the rendered <input> element is disabled.

Beadoc.attributesyntaxvalue:

boolean_disabled

Beadoc.databindable:

Read Only

getReadonly

public boolean getReadonly()

Gets if this TextBox is read-only.

Returns:

the read-only state

setReadonly

public void setReadonly(boolean readonly)

Set if this TextBox is read-only.

Parameters:

readonly - - the read-only state

Beadoc.attributedescription:

Boolean. Determines if the rendered <input> element is read-only.

Beadoc.attributesyntaxvalue:

boolean_readOnly

Beadoc.databindable:

false

getSize

public String getSize()

Gets the size (in characters) of the TextBox.

Returns:

the size

setSize

public void setSize(String size)

Set the size (in characters) of the TextBox.

Parameters:

size - - the size

Beadoc.attributedescription:

Integer. The number of characters visible in the <input> element.

Beadoc.attributesyntaxvalue:

integer_size

Beadoc.databindable:

Read Only

getTagId

public String getTagId()

Return the ID of the textbox.

Returns:

the ID.

setTagId

public void setTagId(String tagId)

Set the ID of the textbox.

Parameters:

tagId - - the ID.

Beadoc.attributedescription:

String value. Sets the id (or name) attribute of the rendered HTML tag. Note that the real id attribute rendered in the browser may be changed by the application container (for example, Portal containers may change the rendered id value to ensure the uniqueness of id's on the page). In this case, the real id rendered in the browser may be looked up through the JavaScript function getNetuiTagName( tagId, tag ).

For example, assume that some tag's tagId attribute is set to foo.

    <netui:textBox tagId="foo" />

Then the following JavaScript function will return the real id attribute rendered in the browser:

    getNetuiTagName( "foo", this )

To get a <netui:form> element and all of its children elements in JavaScript, use the same JavaScript function getNetuiTagName( tagId, tag ). For example, assume that there is a <netui:form> whose tagId attribute is set to bar.

    <netui:form tagId="bar" >

Then the following JavaScript function will return the <netui:form> element and its children (packaged as an array).

    document[getNetuiTagName( "bar", this )]

To retreive the value entered into a <netui:textBox> within the <netui:form> tag, use the following JavaScript expression.

    document[getNetuiTagName("bar", this)][getNetuiTagName("foo", this)].value

The second parameter ensures that the JavaScript function begins its search within the correct Portlet scope. Pass the JavaScript keyword this as the second parameter. For detailed information on using the function getNetuiTagName( tagId, tag ) see Using JavaScript in Page Flow and Portal Applications.

Beadoc.attributesyntaxvalue:

string_tagId

Beadoc.databindable:

false

doStartTag

public int doStartTag()
               throws javax.servlet.jsp.JspException

Prepare the TextBox's formatters.

Specified by:

doStartTag in interface javax.servlet.jsp.tagext.Tag

Overrides:

doStartTag in class javax.servlet.jsp.tagext.BodyTagSupport

Throws:

javax.servlet.jsp.JspException - if a JSP exception has occurred

doEndTag

public int doEndTag()
             throws javax.servlet.jsp.JspException

Render the TextBox.

Specified by:

doEndTag in interface javax.servlet.jsp.tagext.Tag

Overrides:

doEndTag in class javax.servlet.jsp.tagext.BodyTagSupport

Throws:

javax.servlet.jsp.JspException - if a JSP exception has occurred

localRelease

protected void localRelease()

Release any acquired resources.

Overrides:

localRelease in class DefaultableDataSourceTag

addFormatter

public void addFormatter(FormatTag.Formatter formatter)

Adds a FormatTag.Formatter to the TextBox's set of formatters

Specified by:

addFormatter in interface Formattable

Parameters:

formatter - - a FormatTag.Formatter added by a child FormatTag.

formatText

protected String formatText(Object text)

Exclude:

setTabindex

public void setTabindex(String tabindex)

Sets the tabIndex of the rendered html tag.

Parameters:

tabindex - - the tab index.

Beadoc.attributedescription:

The tabIndex of the rendered HTML tag. This attribute determines the position of the tag in the sequence of page elements that the user may advance through by pressing the TAB key.

Beadoc.attributesyntaxvalue:

string_tabIndex

Beadoc.databindable:

false

getTabindex

public String getTabindex()

Gets the tabIndex of the rendered html tag.

Returns:

the tabindex.

setStyle

public void setStyle(String style)

Sets the style of the rendered html tag.

Parameters:

style - - the html style.

Beadoc.attributedescription:

The style of the rendered HTML tag.

Beadoc.attributesyntaxvalue:

string_Style

Beadoc.databindable:

false

getStyle

public String getStyle()

Gets the style of the rendered html tag.

Returns:

the style.

setStyleClass

public void setStyleClass(String styleClass)

Sets the style class of the rendered html tag.

Parameters:

styleClass - - the html style class.

Beadoc.attributedescription:

The class of the rendered HTML tag.

Beadoc.attributesyntaxvalue:

string_Class

Beadoc.databindable:

false

getStyleClass

public String getStyleClass()

Gets the style class of the rendered html tag.

Returns:

the style class.

getAccessKey

public String getAccessKey()

Gets the accessKey attribute value.

Returns:

the accessKey value.

setAccessKey

public void setAccessKey(String accessKey)

Sets the accessKey attribute value. This should key value of the keyboard navigation key. It is recommended not to use the following values because there are often used by browsers A, C, E, F, G, H, V, left arrow, and right arrow.

Parameters:

accessKey - - the accessKey value.

Beadoc.attributedescription:

The keyboard navigation key for the element. The following values are not recommended because they are often used by browsers: A, C, E, F, G, H, V, left arrow, and right arrow

Beadoc.attributesyntaxvalue:

string_accessKey

Beadoc.databindable:

false

getAlt

public String getAlt()

Gets the alt attribute on the generate <input tag.

Returns:

the alt value.

setAlt

public void setAlt(String alt)

Sets the alt attribute value.

Parameters:

alt - - the alt value.

Beadoc.attributedescription:

The alt attribute of the element.

Beadoc.attributesyntaxvalue:

string_alt

Beadoc.databindable:

Read Only

getOnClick

public String getOnClick()

Gets the onClick javascript event.

Returns:

the onClick event.

setOnClick

public void setOnClick(String onclick)

Sets the onClick javascript event.

Parameters:

onclick - - the onClick event.

Beadoc.attributedescription:

The onClick JavaScript event.

Beadoc.attributesyntaxvalue:

string_onClick

Beadoc.databindable:

false

getOnDblClick

public String getOnDblClick()

Gets the onDblClick javascript event.

Returns:

the onDblClick event.

setOnDblClick

public void setOnDblClick(String ondblclick)

Sets the onDblClick javascript event.

Parameters:

ondblclick - - the onDblClick event.

Beadoc.attributedescription:

The onDblClick JavaScript event.

Beadoc.attributesyntaxvalue:

string_onDblClick

Beadoc.databindable:

false

getOnKeyDown

public String getOnKeyDown()

Gets the onKeyDown javascript event.

Returns:

the onKeyDown event.

setOnKeyDown

public void setOnKeyDown(String onkeydown)

Sets the onKeyDown javascript event.

Parameters:

onkeydown - - the onKeyDown event.

Beadoc.attributedescription:

The onKeyDown JavaScript event.

Beadoc.attributesyntaxvalue:

string_onKeyDown

Beadoc.databindable:

false

getOnKeyPress

public String getOnKeyPress()

Gets the onKeyPress javascript event.

Returns:

the onKeyPress event.

setOnKeyPress

public void setOnKeyPress(String onkeypress)

Sets the onKeyPress javascript event.

Parameters:

onkeypress - - the onKeyPress event.

Beadoc.attributedescription:

The onKeyPress JavaScript event.

Beadoc.attributesyntaxvalue:

string_onKeyPress

Beadoc.databindable:

false

getOnKeyUp

public String getOnKeyUp()

Gets the onKeyUp javascript event.

Returns:

the onKeyUp event.

setOnKeyUp

public void setOnKeyUp(String onkeyup)

Sets the onKeyUp javascript event.

Parameters:

onkeyup - - the onKeyUp event.

Beadoc.attributedescription:

The onKeyUp JavaScript event.

Beadoc.attributesyntaxvalue:

string_onKeyUp

Beadoc.databindable:

false

getOnMouseDown

public String getOnMouseDown()

Gets the onMouseDown javascript event.

Returns:

the onMouseDown event.

setOnMouseDown

public void setOnMouseDown(String onmousedown)

Sets the onMouseDown javascript event.

Parameters:

onmousedown - - the onMouseDown event.

Beadoc.attributedescription:

The onMouseDown JavaScript event.

Beadoc.attributesyntaxvalue:

string_onMouseDown

Beadoc.databindable:

false

getOnMouseMove

public String getOnMouseMove()

Gets the onMouseMove javascript event.

Returns:

the onMouseMove event.

setOnMouseMove

public void setOnMouseMove(String onmousemove)

Sets the onMouseMove javascript event.

Parameters:

onmousemove - - the onMouseMove event.

Beadoc.attributedescription:

The onMouseMove JavaScript event.

Beadoc.attributesyntaxvalue:

string_onMouseMove

Beadoc.databindable:

false

getOnMouseOut

public String getOnMouseOut()

Gets the onMouseOut javascript event.

Returns:

the onMouseOut event.

setOnMouseOut

public void setOnMouseOut(String onmouseout)

Sets the onMouseOut javascript event.

Parameters:

onmouseout - - the onMouseOut event.

Beadoc.attributedescription:

The onMouseOut JavaScript event.

Beadoc.attributesyntaxvalue:

string_onMouseOut

Beadoc.databindable:

false

getOnMouseOver

public String getOnMouseOver()

Gets the onMouseOver javascript event.

Returns:

the onMouseOver event.

setOnMouseOver

public void setOnMouseOver(String onmouseover)

Sets the onMouseOver javascript event.

Parameters:

onmouseover - - the onMouseOver event.

Beadoc.attributedescription:

The onMouseOver JavaScript event.

Beadoc.attributesyntaxvalue:

string_onMouseOver

Beadoc.databindable:

false

getOnMouseUp

public String getOnMouseUp()

Gets the onMouseUp javascript event.

Returns:

the onMouseUp event.

setOnMouseUp

public void setOnMouseUp(String onmouseup)

Sets the onMouseUp javascript event.

Parameters:

onmouseup - - the onMouseUp event.

Beadoc.attributedescription:

The onMouseUp JavaScript event.

Beadoc.attributesyntaxvalue:

string_onMouseUp

Beadoc.databindable:

false

getOnBlur

public String getOnBlur()

Gets the onBlur javascript event.

Returns:

the onBlur event.

setOnBlur

public void setOnBlur(String onblur)

Sets the onBlur javascript event.

Parameters:

onblur - - the onBlur event.

Beadoc.attributedescription:

The onBlur JavaScript event.

Beadoc.attributesyntaxvalue:

string_onBlur

Beadoc.databindable:

false

getOnFocus

public String getOnFocus()

Gets the onFocus javascript event.

Returns:

the onFocus event.

setOnFocus

public void setOnFocus(String onfocus)

Sets the onFocus javascript event.

Parameters:

onfocus - - the onFocus event.

Beadoc.attributedescription:

The onFocus JavaScript event.

Beadoc.attributesyntaxvalue:

string_onFocus

Beadoc.databindable:

false

getOnChange

public String getOnChange()

Gets the onChange javascript event.

Returns:

the onChange event.

setOnChange

public void setOnChange(String onchange)

Sets the onChange javascript event.

Parameters:

onchange - - the onChange event.

Beadoc.attributedescription:

The onChange JavaScript event.

Beadoc.attributesyntaxvalue:

string_onChange

Beadoc.databindable:

false

getOnSelect

public String getOnSelect()

Gets the onSelect javascript event.

Returns:

the onSelect event.

setOnSelect

public void setOnSelect(String onselect)

Sets the onSelect javascript event.

Parameters:

onselect - - the onSelect event.

Beadoc.attributedescription:

The onSelect JavaScript event.

Beadoc.attributesyntaxvalue:

string_onSelect

Beadoc.databindable:

false