INPUT TYPE=button XHTML Element

Article
08/28/2006

The INPUT TYPE=button element creates a button control. 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 for All DOM 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, events and methods.

Attributes

Attribute	Value	PPC	SP	Description
ACCESSKEY	0...9, #, *	Yes	Yes	Gives access or focus to an active HTML element by using a keypad number. Note For Pocket PCs, supported only for devices running Windows Mobile 2003 software or later.
ALIGN		Yes	Yes	Specifies the alignment of text following the IMG reference relative to the graphic on screen. Note Supported only for devices running PocketPC 2002 and Smartphone 2002 software or later.
	absbottom	Yes	Yes	This attribute is equivalent to the CSS: `vertical-align: text-bottom;`
	absmiddle	Yes	Yes	This attribute is equivalent to the CSS: `vertical-align: middle;`
	baseline	Yes	Yes	This attribute is equivalent to the CSS: `vertical-align: baseline;`
	bottom	Yes	Yes	This attribute is equivalent to the CSS: `vertical-align: bottom;`
	left	Yes	Yes	This attribute is equivalent to the CSS: `vertical-align: left;`
	middle	Yes	Yes	This attribute is equivalent to the CSS: `vertical-align: middle;`
	right	Yes	Yes	This attribute is equivalent to the CSS: `vertical-align: right;`
	texttop	Yes	Yes	This attribute is equivalent to the CSS: `vertical-align: text-top;`
	top	Yes	Yes	This attribute is equivalent to the CSS: `vertical-align: top;`
	absbottom	Yes	Yes	This attribute is equivalent to the CSS: `vertical-align: text-bottom;`
CLASS		Yes	Yes	Associates the element with a CSS style. Note Supported only for devices running Windows Mobile 2003 software or later.
DISABLED		Yes	Yes	Disables the button 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		Yes	Yes	Uniquely identifies the element within a document. Note Supported only for devices running Windows Mobile 2003 software or later
NAME	String	Yes	Yes	Specifies the button control name.
ONBLUR		Yes	Yes	Event that occurs when the button control loses focus by the pointing device or by tabbing navigation. Note Supported only for devices running PocketPC 2002 and Smartphone 2002 software or later.
ONCLICK		Yes	Yes	Event that occurs when the user chooses the button control. Note Supported only for devices running PocketPC 2002 and Smartphone 2002 software or later.
ONFOCUS		Yes	Yes	Event that occurs when the button control receives focus by a pointing device or by tabbing navigation. Note Supported only for devices running PocketPC 2002 and Smartphone 2002 software or later.
STYLE		Yes	Yes	Provides the definition of the CSS styles used for this element. Note Supported only for devices running Windows Mobile 2003 software or later.
TABINDEX		Yes	Yes	Sets the order in which elements are tabbed to. Note Supported only for devices running Windows Mobile 2003 software or later.
VALUE	String	Yes	Yes	Specifies the button control text value. This text is displayed as the button's label. Buttons wider than the device screen are visually clipped.

Scripting Properties

Property	Type	Access	Comments
accessKey	string	Read/Write
disabled	boolean	Read/Write
form	object	Read Only
name	string	Read Only
type	string	Read Only	Always returns: button
value	string	Read/Write	Sets or retrieves the value of the input type=button.

Scripting Events

Event	Supported	Comment
onclick	Yes	This event fires when the user taps on the button element. Note the event only fires if the user does a pen down while on the button and a pen up over the same button. The author can specify special handler for this event.
onblur	Yes
onfocus	Yes

Scripting Methods

Method Support Comments

click

Yes

Method	Support	Comments
click	Yes	Syntax: `button.click()` Simulates clicking the button causing the onclick event to fire.
focus	Yes	Syntax: `button.focus()` Sets focus to the button.

Syntax:

button.click()

Simulates clicking the button causing the onclick event to fire.

focus

Yes

Syntax:

button.focus()

Sets focus to the button.

Requirements

Pocket PC: Windows Mobile 5.0 and later
Smartphone: Windows Mobile 5.0 and later
OS Versions: Windows CE 5.01 and later

Share via