Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The INPUT TYPE=passwordelement creates a single-line text entry control, similar to the text control except that text is not displayed as the user enters it. This is an inline element and does not require a closing tag.

Using this Element

There are some common properties and collections that apply to all the elements of the document object model, see Common Properties, Methods and Collections for the HTML Elements in Internet Explorer Mobile.

This element can be used within a web page with attributes.

This element can be used within scripts where it will have properties, eventsand methods.

Attributes

The following table shows items that Internet Explorer Mobile supports.

Attribute Value Description

ACCESSKEY

0…9, #, *

Gives access or focus to an active HTML element by using a keypad number.

Note:
For Pocket PC for Windows Mobile 2003 Second Edition or later.

CLASS

 

Associates the element with a CSS style.

Note:
Supported only for devices running Windows Mobile 2003 software or later.

DISABLED

 

Disables the element so that it appears dimmed and does not respond to user input.

Note:
Supported only for devices running Windows Mobile 2003 software or later.

ID

 

Uniquely identifies the element within a document.

Note:
Supported only for devices running Windows Mobile 2003 software or later.

MAXLENGTH

0…#

Specifies the maximum number of characters a user can enter into the control.

NAME

String

Specifies the text entry control name, which is submitted along with the text entry control value during forms submission.

ONBLUR

 

Event that occurs when the text entry control loses focus by the pointing device or by tabbing navigation.

Note:
Supported only for devices running Pocket PC 2002 and Smartphone 2002 software or later.

ONCHANGE

 

Event that occurs when the text entry control loses input focus and its value has been modified since gaining focus.

Note:
Supported only for devices running Pocket PC 2002 and Smartphone 2002 software or later.

ONFOCUS

 

Event that occurs when the text entry control receives focus by the pointing device or by tabbing navigation.

Note:
Supported only for devices running Pocket PC 2002 and Smartphone 2002 software or later.

READONLY

 

 

SIZE

0…#

Specifies the approximate size of the text entry control, in characters. If a control becomes too wide for the device screen, it is limited to slightly less than the screen width.

STYLE

 

Provides the definition of the CSS styles used for this element.

Note:
Supported only for devices running Windows Mobile 2003 software or later.

TABINDEX

 

Sets the order in which elements are tabbed to.

Note:
Supported only for devices running Windows Mobile 2003 software or later.

VALUE

String

Specifies the initial value for the text entry control, which is submitted along with the entry control name during forms submission.

Scripting Properties

The following table shows items that Internet Explorer Mobile supports.

Property Type Access Comments

accessKey

string

Read/Write

Sets or retrieves the number associated with the accesskeyattribute.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

defaultValue

string

Read/Write

Retrieves the default value (initial contents) of the input type=passwordcontrol.

Note:
Read-only for devices running Smartphone 2002 and Pocket PC 2002 software or earlier.

disabled

boolean

Read/Write

Sets or retrieves the value that indicates whether the user can interact with the object.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

form

object

Read

Retrieves a reference to the form that the object is embedded in.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

maxLength

long

Read/Write

Sets or rerieves the maximum number of characters that the user can enter in a text control.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

name

string

Read

Sets or retrieves the name of the input type=passwordcontrol.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

offsetHeight

Number

Read-only

Contains the height of the object in pixels, relative to the parent element.

offsetLeft

Number

Read-only

Contains the number of pixels from the left of the parent element.

offsetParent

String

Read-only

Contains a reference to the container object that defines the offsetTop and offsetLeft properties of the object.

offsetTop

Number

Read-only

Contains the number of pixels from the top of the parent element

offsetWidth

Number

Read-only

Contains the width of the object in pixels, relative to the parent element.

readOnly

boolean

Read/Write

 

size

long

Read

Sets or retrieves the size of the control.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

type

string

Read

Always returns — password.

value

string

Read/Write

Sets or retrieves the value of the input type=passwordcontrol.

Scripting Events

The following table shows items that Internet Explorer Mobile supports.

Event Comment

onblur

Occurs when an element loses focus either by the pointing device or by keypad navigation.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

onchange

Occurs when the contents of the input type=passwordobject have changed and the user has committed the change (by leaving the input type=passwordcontrol that has focus).

onfocus

Occurs when an element receives focus either by the pointing device or by tabbing navigation.

Note:
Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

Scripting Methods

The following table shows items that Internet Explorer Mobile supports.

Method Arguments Comments

blur

 

Syntax:

password.blur()

  • Causes the onblur event to fire.

focus

 

Syntax:

password.focus()

  • Sets focus to the input type=password control.

getAttribute

option

Syntax:

vAttrValue=password.getAttribute(sAttrName[,iFlags])

  • Returns the value of the specified attribute. If the attribute is not present then a NULL is returned.

    sAttrNameis a String containing the name of the attribute.

    iFlagsis an integer that specifies one or more of the following:

    0 (Default) Performs a property search that is not case-sensitive, and returns an interpolated value if the property is found.

    1 Performs a case-sensitive property search. To find a match, the uppercase and lowercase letters in sAttrNamemust exactly match those in the attribute name.

    2 Returns the value exactly as it was set in script or in the source document.

select

 

Syntax:

password.select()

Requirements

Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also