|
||||||||
PREV CLASS NEXT CLASS | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Form control.
Note: Depending upon the environment in which the page is being viewed, the value property may be read-only for the file upload input type. For the "password" input type, the actual value returned may be masked to prevent unauthorized use. See the INPUT element definition in [HTML 4.01].
See also the Document Object Model (DOM) Level 2 HTML Specification.
Fields inherited from interface org.w3c.dom.Node |
ATTRIBUTE_NODE,
CDATA_SECTION_NODE,
COMMENT_NODE,
DOCUMENT_FRAGMENT_NODE,
DOCUMENT_NODE,
DOCUMENT_TYPE_NODE,
ELEMENT_NODE,
ENTITY_NODE,
ENTITY_REFERENCE_NODE,
NOTATION_NODE,
PROCESSING_INSTRUCTION_NODE,
TEXT_NODE |
Method Summary | |
void |
blur() Removes keyboard focus from this element. |
void |
click() Simulate a mouse-click. |
void |
focus() Gives keyboard focus to this element. |
java.lang.String |
getAccept() A comma-separated list of content types that a server processing this form will handle correctly. |
java.lang.String |
getAccessKey() A single character access key to give access to the form control. |
java.lang.String |
getAlign() Aligns this object (vertically or horizontally) with respect to its surrounding text. |
java.lang.String |
getAlt() Alternate text for user agents not rendering the normal content of this element. |
boolean |
getChecked() When the type attribute of the element has the value
"radio" or "checkbox", this represents the current state of the
form control, in an interactive user agent. |
boolean |
getDefaultChecked() When type has the value "radio" or "checkbox", this
represents the HTML checked attribute of the element. |
java.lang.String |
getDefaultValue() When the type attribute of the element has the value
"text", "file" or "password", this represents the HTML value
attribute of the element. |
boolean |
getDisabled() The control is unavailable in this context. |
HTMLFormElement |
getForm() Returns the FORM element containing this control. |
int |
getMaxLength() Maximum number of characters for text fields, when type has
the value "text" or "password". |
java.lang.String |
getName() Form control or object name when submitted with a form. |
boolean |
getReadOnly() This control is read-only. |
int |
getSize() Size information. |
java.lang.String |
getSrc() When the type attribute has the value "image", this
attribute specifies the location of the image to be used to
decorate the graphical submit button. |
int |
getTabIndex() Index that represents the element's position in the tabbing order. |
java.lang.String |
getType() The type of control created (all lower case). |
java.lang.String |
getUseMap() Use client-side image map. |
java.lang.String |
getValue() When the type attribute of the element has the value
"text", "file" or "password", this represents the current contents
of the corresponding form control, in an interactive user
agent. |
void |
select() Select the contents of the text area. |
void |
setAccept(java.lang.String accept) A comma-separated list of content types that a server processing this form will handle correctly. |
void |
setAccessKey(java.lang.String accessKey) A single character access key to give access to the form control. |
void |
setAlign(java.lang.String align) Aligns this object (vertically or horizontally) with respect to its surrounding text. |
void |
setAlt(java.lang.String alt) Alternate text for user agents not rendering the normal content of this element. |
void |
setChecked(boolean checked) When the type attribute of the element has the value
"radio" or "checkbox", this represents the current state of the
form control, in an interactive user agent. |
void |
setDefaultChecked(boolean defaultChecked) When type has the value "radio" or "checkbox", this
represents the HTML checked attribute of the element. |
void |
setDefaultValue(java.lang.String defaultValue) When the type attribute of the element has the value
"text", "file" or "password", this represents the HTML value
attribute of the element. |
void |
setDisabled(boolean disabled) The control is unavailable in this context. |
void |
setMaxLength(int maxLength) Maximum number of characters for text fields, when type has
the value "text" or "password". |
void |
setName(java.lang.String name) Form control or object name when submitted with a form. |
void |
setReadOnly(boolean readOnly) This control is read-only. |
void |
setSize(int size) Size information. |
void |
setSrc(java.lang.String src) When the type attribute has the value "image", this
attribute specifies the location of the image to be used to
decorate the graphical submit button. |
void |
setTabIndex(int tabIndex) Index that represents the element's position in the tabbing order. |
void |
setType(java.lang.String type) The type of control created (all lower case). |
void |
setUseMap(java.lang.String useMap) Use client-side image map. |
void |
setValue(java.lang.String value) When the type attribute of the element has the value
"text", "file" or "password", this represents the current contents
of the corresponding form control, in an interactive user
agent. |
Methods inherited from interface org.w3c.dom.html2.HTMLElement |
getClassName,
getDir,
getId,
getLang,
getTitle,
setClassName,
setDir,
setId,
setLang,
setTitle |
Methods inherited from interface org.w3c.dom.Element |
getAttribute,
getAttributeNode,
getAttributeNodeNS,
getAttributeNS,
getElementsByTagName,
getElementsByTagNameNS, getTagName,
hasAttribute,
hasAttributeNS,
removeAttribute,
removeAttributeNode,
removeAttributeNS,
setAttribute,
setAttributeNode,
setAttributeNodeNS,
setAttributeNS |
Methods inherited from interface org.w3c.dom.Node |
appendChild,
cloneNode,
getAttributes,
getChildNodes,
getFirstChild,
getLastChild,
getLocalName,
getNamespaceURI,
getNextSibling,
getNodeName,
getNodeType,
getNodeValue,
getOwnerDocument,
getParentNode,
getPrefix,
getPreviousSibling,
hasAttributes,
hasChildNodes,
insertBefore,
isSupported, normalize,
removeChild,
replaceChild, setNodeValue,
setPrefix |
Method Detail |
public void blur()
public void click()
INPUT
elements whose
type
attribute has one of the following values:
"button", "checkbox", "radio", "reset", or "submit".public void focus()
public java.lang.String getAccept()
public java.lang.String getAccessKey()
public java.lang.String getAlign()
public java.lang.String getAlt()
public boolean getChecked()
type
attribute of the element has the
value "radio" or "checkbox", this represents the current state of
the form control, in an interactive user agent. Changes to this
attribute change the state of the form control, but do not change
the value of the HTML checked attribute of the INPUT element.
Note: During the handling of a click event on an input element with a type attribute that has the value "radio" or "checkbox", some implementations may change the value of this property before the event is being dispatched in the document. If the default action of the event is canceled, the value of the property may be changed back to its original value. This means that the value of this property during the handling of click events is implementation dependent.
public boolean getDefaultChecked()
type
has the value "radio" or "checkbox",
this represents the HTML checked attribute of the element. The
value of this attribute does not change if the state of the
corresponding form control, in an interactive user agent, changes.
See the
checked attribute definition in HTML 4.01.public java.lang.String getDefaultValue()
type
attribute of the element has the
value "text", "file" or "password", this represents the HTML value
attribute of the element. The value of this attribute does not
change if the contents of the corresponding form control, in an
interactive user agent, changes. See the
value attribute definition in HTML 4.01.public boolean getDisabled()
public HTMLFormElement getForm()
FORM
element containing this control.
Returns null
if this control is not within the context
of a form.public int getMaxLength()
type
has the value "text" or "password". See the
maxlength attribute definition in HTML 4.01.public java.lang.String getName()
public boolean getReadOnly()
type
has the value "text" or "password". See the
readonly attribute definition in HTML 4.01.public int getSize()
public java.lang.String getSrc()
type
attribute has the value "image",
this attribute specifies the location of the image to be used to
decorate the graphical submit button. See the
src attribute definition in HTML 4.01.public int getTabIndex()
public java.lang.String getType()
public java.lang.String getUseMap()
public java.lang.String getValue()
type
attribute of the element has the
value "text", "file" or "password", this represents the current
contents of the corresponding form control, in an interactive user
agent. Changing this attribute changes the contents of the form
control, but does not change the value of the HTML value attribute
of the element. When the type
attribute of the element
has the value "button", "hidden", "submit", "reset", "image",
"checkbox" or "radio", this represents the HTML value attribute of
the element. See the
value attribute definition in HTML 4.01.public void select()
INPUT
elements whose type
attribute has one of the following
values: "text", "file", or "password".public void setAccept(java.lang.String accept)
public void setAccessKey(java.lang.String accessKey)
public void setAlign(java.lang.String align)
public void setAlt(java.lang.String alt)
public void setChecked(boolean checked)
type
attribute of the element has the
value "radio" or "checkbox", this represents the current state of
the form control, in an interactive user agent. Changes to this
attribute change the state of the form control, but do not change
the value of the HTML checked attribute of the INPUT element.
Note: During the handling of a click event on an input element with a type attribute that has the value "radio" or "checkbox", some implementations may change the value of this property before the event is being dispatched in the document. If the default action of the event is canceled, the value of the property may be changed back to its original value. This means that the value of this property during the handling of click events is implementation dependent.
public void setDefaultChecked(boolean defaultChecked)
type
has the value "radio" or "checkbox",
this represents the HTML checked attribute of the element. The
value of this attribute does not change if the state of the
corresponding form control, in an interactive user agent, changes.
See the
checked attribute definition in HTML 4.01.public void setDefaultValue(java.lang.String defaultValue)
type
attribute of the element has the
value "text", "file" or "password", this represents the HTML value
attribute of the element. The value of this attribute does not
change if the contents of the corresponding form control, in an
interactive user agent, changes. See the
value attribute definition in HTML 4.01.public void setDisabled(boolean disabled)
public void setMaxLength(int maxLength)
type
has the value "text" or "password". See the
maxlength attribute definition in HTML 4.01.public void setName(java.lang.String name)
public void setReadOnly(boolean readOnly)
type
has the value "text" or "password". See the
readonly attribute definition in HTML 4.01.public void setSize(int size)
public void setSrc(java.lang.String src)
type
attribute has the value "image",
this attribute specifies the location of the image to be used to
decorate the graphical submit button. See the
src attribute definition in HTML 4.01.public void setTabIndex(int tabIndex)
public void setType(java.lang.String type)
public void setUseMap(java.lang.String useMap)
public void setValue(java.lang.String value)
type
attribute of the element has the
value "text", "file" or "password", this represents the current
contents of the corresponding form control, in an interactive user
agent. Changing this attribute changes the contents of the form
control, but does not change the value of the HTML value attribute
of the element. When the type
attribute of the element
has the value "button", "hidden", "submit", "reset", "image",
"checkbox" or "radio", this represents the HTML value attribute of
the element. See the
value attribute definition in HTML 4.01.
|
||||||||
PREV CLASS NEXT CLASS | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 2003 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark, document use and software licensing rules apply. Your interactions with this site are in accordance with our public and Member privacy statements.