/* |
|
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
|
* |
|
* This code is free software; you can redistribute it and/or modify it |
|
* under the terms of the GNU General Public License version 2 only, as |
|
* published by the Free Software Foundation. Oracle designates this |
|
* particular file as subject to the "Classpath" exception as provided |
|
* by Oracle in the LICENSE file that accompanied this code. |
|
* |
|
* This code 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 the GNU General Public License |
|
* version 2 for more details (a copy is included in the LICENSE file that |
|
* accompanied this code). |
|
* |
|
* You should have received a copy of the GNU General Public License version |
|
* 2 along with this work; if not, write to the Free Software Foundation, |
|
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
|
* |
|
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
|
* or visit www.oracle.com if you need additional information or have any |
|
* questions. |
|
*/ |
|
/* |
|
* This file is available under and governed by the GNU General Public |
|
* License version 2 only, as published by the Free Software Foundation. |
|
* However, the following notice accompanied the original version of this |
|
* file and, per its terms, should not be removed: |
|
* |
|
* 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. |
|
* <p>See also the <a href='http://www.w3.org/TR/2000/CR-DOM-Level-2-20000510'>Document Object Model (DOM) Level 2 Specification</a>. |
|
* |
|
* @since 1.4, DOM Level 2 |
|
*/ |
|
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(); |
|
} |