onblur event
Fires when the object loses the input focus.
Syntax
HTML Attribute | <element onblur = "handler(event)"> |
Event Property | object.onblur = handler; |
attachEvent Method | object.attachEvent("onblur", handler) |
addEventListener Method | object.addEventListener("blur", handler, useCapture) |
Event information
Synchronous | No |
Bubbles | No |
Cancelable | No |
Event handler parameters
- pEvtObj [in]
Type: IHTMLEventObj
Standards information
- HTML 4.01 Specification, Section 18.2.3
Remarks
The HTMLWindowEvents::onblur event fires on the original object before the HTMLWindowEvents::onfocus or HTMLFrameSiteEvents::onclick event fires on the object that is receiving focus. Where applicable, the HTMLWindowEvents::onblur event fires after the HTMLSelectElementEvents::onchange event.
Use the focus events to determine when to prepare an object to receive or validate input from the user.
As of Microsoft Internet Explorer 5, you must set the IHTMLElement2::tabIndex attribute of elements that expose the HTMLWindowEvents::onblur event.
For Internet Explorer 5 and later, the HTMLWindowEvents::onblur event is asynchronous.
Switches focus away from the object on which the event is fired.
To invoke this event, do one of the following:
- Click the mouse on the document background or another control.
- Use the keyboard to navigate from one object to the next.
- Invoke the IHTMLElement2::blur method when an object has focus.
- Switch focus to a different application or open a second window.
The pEvtObj parameter is required for the following interfaces:
- HTMLAnchorEvents2
- HTMLAreaEvents2
- HTMLButtonElementEvents2
- HTMLControlElementEvents2
- HTMLDocumentEvents2
- HTMLElementEvents2
- HTMLFormElementEvents2
- HTMLImgEvents2
- HTMLFrameSiteEvents2
- HTMLInputFileElementEvents2
- HTMLInputImageEvents2
- HTMLInputTextElementEvents2
- HTMLLabelEvents2
- HTMLLinkElementEvents2
- HTMLMapEvents2
- HTMLMarqueeElementEvents2
- HTMLObjectElementEvents2
- HTMLOptionButtonElementEvents2
- HTMLScriptEvents2
- HTMLSelectElementEvents2
- HTMLStyleElementEvents2
- HTMLTableEvents2
- HTMLTextContainerEvents2
- HTMLWindowEvents2
- HTMLDocumentEvents4
See also
Reference