The following table lists the standard properties available for HTML objects. Standard properties provide a common way to access properties and their values across browsers. Most of these properties are modeled on HTML element attributes defined by the W3C. See http://www.w3.org/TR/html401/index/attributes.html.
Property | Use |
---|---|
.align |
Value of the align attribute of the element. Valid values are bottom, middle, and top. |
.alt |
Value of the alt attribute of an element. This is the "alternate" text for the element, usually displayed by the browser when the mouse hovers over the element. |
.border |
Value of the border attribute of the element. Returns the number of pixels. |
.bounds |
Rectangle that represents the bounding rectangle of the object in screen coordinates. |
.caption |
For TABLE elements, the value of the caption attribute. For an HTML dialog box, this is the name of the dialog box. |
.cellIndex |
Cell index of an element with respect to its row (>=0). |
.checked |
Boolean value that indicates whether a check box is checked (true) or not (false). |
.class |
TestObject class name; for example, "HtmlTable" for a TABLE element. |
.className |
Value of the class attribute of an element (used for stylesheets in HTML). |
.clientRect |
Bounding rectangle of the element in client coordinates. |
.code |
Value of the code attribute of an APPLET element. |
.codeBase |
Value of the codeBase attribute of an APPLET element. |
.colSpan |
Value of the colSpan attribute of an element. |
.cookie |
Current value of the cookie for the document. |
.coords |
Value of the coords attribute of an element. This is a string containing the coordinates used to define the AREA element of a client-side image map. In the form x1, y1, x2, y2, and so on. |
.defaultChecked |
Boolean value for the defaultChecked attribute of the element. |
.defaultSelected |
Boolean value; when true indicates that the OPTION element in a SELECT element (listbox or dropdown) is selected by default when the page is displayed. |
.defaultValue |
Value of the defaultValue attribute of the element. |
.disabled |
Value of the disabled attribute of an element, returned as a boolean. If true, user input is currently disabled for this item. |
.hasFocus |
Indicates whether the current element has focus. This attribute is not implemented on Netscape. |
.hasScript |
Boolean value; true when a script has been associated with actions on this element. |
.height |
Value of the height attribute of an element. For an Image element, this is the display height in pixels for the image. |
.href |
Value of the href attribute of an element. This is a URL used by ANCHOR and AREA elements to indicate the result of clicking the corresponding element. |
.hspace |
Value of the hspace attribute of an element, the amount of whitespace inserted to the left or right of an IMG, OBJECT, or APPLET element. |
.id |
Value of the id attribute of an element. |
.indeterminate |
Boolean value; true when the status of the check box has been changed. |
.index |
Index of the OPTION element within a listbox or combodropdown list. |
.isMap |
Boolean value; for Image elements (IMG), this value is true when the element is a server-side image map. |
.length |
Value of the length attribute of an element. For a SELECT element, this indicates the number of items in the list. |
.maxLength |
For an edit control (Input type=Text or TextArea) this indicates the maximum number of characters a user can enter. |
.multiple |
Boolean value; for a SELECT element (listbox or combo dropdown), a value of true indicates that the list supports multiple selections. |
.name |
Value of the name attribute (Form elements and Frames only). |
.noHref |
Value of the noHref attribute of an element. When set on an AREA element, indicates that the corresponding area has no associated action. |
.offsetHeight |
Height of the element. |
.offsetLeft |
Offset, in pixels, of the element from its left edge to the left edge of its parent element in the DOM. |
.offsetRight |
Offset, in pixels, of the element from its right edge to the right edge of its parent element in the DOM. |
.offsetTop |
Offset of the element from the offset of its parent element in the DOM. |
.offsetWidth |
Width of the element. |
.readOnly |
Value of the readOnly attribute of an element. Boolean value; true when the form element is read-only. |
.readyState |
Current status of a browser, indicating whether it is currently loading a document or ready for user input. This is an integer value: 0 - Uninitialized 1 - Loading 2 - Loaded 3- Interactive 4 - Complete (ready) |
.rowIndex |
Row index of an element in a table (>=0 ). |
.rows |
Value of the rows attribute of a TEXTAREA element, indicating the size of the edit control in the number of rows of text. |
.rowSpan |
Value of the rowSpan attribute of an element. |
.screenLeft |
Upper left corner of bounding rectangle in screen coordinates, x component. |
.screenTop |
Upper left corner of bounding rectangle in screen coordinates, y component. |
.select |
Boolean value; true when the FORM element is highlighted to receive user input. |
.selected |
Boolean value; true when the OPTION element in a SELECT element (listbox or dropdown) is selected. |
.selectedIndex |
Value of the selectedIndex attribute of an element. For a single selection Select element, this indicates which option element is selected. Integer in the range of >=0. |
.shape |
Value of the shape attribute of an element. Used for AREA elements in client-side image maps. Valid values are default, rect, circle, and poly. |
.size |
Value of the size attribute of an element. For a Select element, the number of items displayed at one time in the list. If size > 1, the list appears as listbox; otherwise the list appears as a Combodropdown. |
.src |
Value of the src attribute for the element. For images and image buttons, this is a URL specifying the image file. |
.tag |
HTML tag for the element. |
.target |
Value of the target attribute of an element. For anchors, this indicates the name of the target frame, that is, the frame where the document should be opened. |
.text |
Text inside of the HTML tags for bounding the element. For example: The text property returns "This is an Anchor." If consecutive white space characters are found, all white spaces are combined and reduced to a single blank character. |
.title |
Value of the title attribute of an element. This is frequently the text displayed when hovering over the element with the mouse. |
.type |
Value of the type attribute of an element. For example, for an Input element this is text, password, check box, radio, submit, image, reset, button, hidden, or file. |
.url |
URL of the document. |
.useMap |
Value of the useMap attribute of an element. The value is a string specifying a URL and is used for IMAGE elements (IMG) to indicate a client-side image map. The URL points to the map associated MAP element. Frequently, this is a document-relative reference. |
.value |
Value of the value attribute of an element. In Form elements this represents the value sent when the form is posted. |
.vspace |
Value of the vspace attribute of an element, the amount of whitespace inserted to the above or below an IMG, OBJECT, or APPLET element. |
.width |
Value of the width attribute of an element. For an IMAGE element, this is the display width in pixels for the image. |
.window |
Heavyweight window for the element returned as a long. For the Browser, this is the top-level window. |
Terms of use | Feedback
(C) Copyright IBM Corporation 2002, 2004. All Rights Reserved.