HTML Standard Properties

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:

 <A>This is an Anchor<IMG src=map.gif></a>

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.