| /* |
| * Copyright (c) 2000 World Wide Web Consortium, |
| * (Massachusetts Institute of Technology, Institut National de |
| * Recherche en Informatique et en Automatique, Keio University). All |
| * Rights Reserved. This program is distributed under the W3C's Software |
| * Intellectual Property License. This program is distributed in the |
| * hope that it will be useful, but WITHOUT ANY WARRANTY; without even |
| * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR |
| * PURPOSE. See W3C License http://www.w3.org/Consortium/Legal/ for more |
| * details. |
| */ |
| |
| package org.w3c.dom.html; |
| |
| /** |
| * 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.0. |
| */ |
| public interface HTMLInputElement extends HTMLElement { |
| /** |
| * When the <code>type</code> 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. Changing this attribute, however, resets the contents |
| * of the form control. See the value attribute definition in HTML 4.0. |
| */ |
| public String getDefaultValue(); |
| public void setDefaultValue(String defaultValue); |
| |
| /** |
| * When <code>type</code> 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. Changes to this |
| * attribute, however, resets the state of the form control. See the |
| * checked attribute definition in HTML 4.0. |
| */ |
| public boolean getDefaultChecked(); |
| public void setDefaultChecked(boolean defaultChecked); |
| |
| /** |
| * Returns the <code>FORM</code> element containing this control. Returns |
| * <code>null</code> if this control is not within the context of a form. |
| */ |
| public HTMLFormElement getForm(); |
| |
| /** |
| * A comma-separated list of content types that a server processing this |
| * form will handle correctly. See the accept attribute definition in |
| * HTML 4.0. |
| */ |
| public String getAccept(); |
| public void setAccept(String accept); |
| |
| /** |
| * A single character access key to give access to the form control. See |
| * the accesskey attribute definition in HTML 4.0. |
| */ |
| public String getAccessKey(); |
| public void setAccessKey(String accessKey); |
| |
| /** |
| * Aligns this object (vertically or horizontally) with respect to its |
| * surrounding text. See the align attribute definition in HTML 4.0. |
| * This attribute is deprecated in HTML 4.0. |
| */ |
| public String getAlign(); |
| public void setAlign(String align); |
| |
| /** |
| * Alternate text for user agents not rendering the normal content of |
| * this element. See the alt attribute definition in HTML 4.0. |
| */ |
| public String getAlt(); |
| public void setAlt(String alt); |
| |
| /** |
| * When the <code>type</code> 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 value attribute of the element. |
| */ |
| public boolean getChecked(); |
| public void setChecked(boolean checked); |
| |
| /** |
| * The control is unavailable in this context. See the disabled |
| * attribute definition in HTML 4.0. |
| */ |
| public boolean getDisabled(); |
| public void setDisabled(boolean disabled); |
| |
| /** |
| * Maximum number of characters for text fields, when <code>type</code> |
| * has the value "Text" or "Password". See the maxlength attribute |
| * definition in HTML 4.0. |
| */ |
| public int getMaxLength(); |
| public void setMaxLength(int maxLength); |
| |
| /** |
| * Form control or object name when submitted with a form. See the name |
| * attribute definition in HTML 4.0. |
| */ |
| public String getName(); |
| public void setName(String name); |
| |
| /** |
| * This control is read-only. Relevant only when <code>type</code> has |
| * the value "Text" or "Password". See the readonly attribute definition |
| * in HTML 4.0. |
| */ |
| public boolean getReadOnly(); |
| public void setReadOnly(boolean readOnly); |
| |
| /** |
| * Size information. The precise meaning is specific to each type of |
| * field. See the size attribute definition in HTML 4.0. |
| */ |
| public String getSize(); |
| public void setSize(String size); |
| |
| /** |
| * When the <code>type</code> 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.0. |
| */ |
| public String getSrc(); |
| public void setSrc(String src); |
| |
| /** |
| * Index that represents the element's position in the tabbing order. See |
| * the tabindex attribute definition in HTML 4.0. |
| */ |
| public int getTabIndex(); |
| public void setTabIndex(int tabIndex); |
| |
| /** |
| * The type of control created. See the type attribute definition in |
| * HTML 4.0. |
| */ |
| public String getType(); |
| |
| /** |
| * Use client-side image map. See the usemap attribute definition in |
| * HTML 4.0. |
| */ |
| public String getUseMap(); |
| public void setUseMap(String useMap); |
| |
| /** |
| * When the <code>type</code> 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 |
| * <code>type</code> 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.0. |
| */ |
| public String getValue(); |
| public void setValue(String value); |
| |
| /** |
| * Removes keyboard focus from this element. |
| */ |
| public void blur(); |
| |
| /** |
| * Gives keyboard focus to this element. |
| */ |
| public void focus(); |
| |
| /** |
| * Select the contents of the text area. For <code>INPUT</code> elements |
| * whose <code>type</code> attribute has one of the following values: |
| * "Text", "File", or "Password". |
| */ |
| public void select(); |
| |
| /** |
| * Simulate a mouse-click. For <code>INPUT</code> elements whose |
| * <code>type</code> attribute has one of the following values: "Button", |
| * "Checkbox", "Radio", "Reset", or "Submit". |
| */ |
| public void click(); |
| |
| } |
| |