back to Overview

.onFocus()

Registers a function to be called when a list element either gets the focus or the focus is removed (blur).
Web module only.

Syntax Variants

list.onFocus(handler)
list.onFocus(selector, handler)

Parameters

selector (optional)
a selector string for $() to register the event only on those children of the list elements that match the selector. Supports all valid parameters for $() except functions.
toggle
the callback function(hasFocus) to invoke when the event has been triggered:
hasFocus
true if an element gets the focus, false when an element looses it.
this
A Minified list containing the target element that caused the event as only item.
bubbleSelector (optional)
a selector string for $() to receive only events that bubbled up from an element that matches this selector. Supports all valid parameters for $() except functions. Analog to is(), the selector is optimized for the simple patterns '.classname', 'tagname' and 'tagname.classname'.
(return value)
the list

Description

Registers a function to be called when a list element either gets the focus or the focus is removed (blur). The handler is called with a boolean parameter, true for entering and false for leaving, which allows you to use any toggle() function as handler.

Example

Creates a toggle that changes the text color of the element on focus: 

$('#focusSensitive').onFocus($('#focusSensitive').toggle({$color:'#000'}, {$color:'#f00'}, 100));

See also..

  • on() provides low-level event registration.

Comments

comments powered by Disqus

back to Overview

Functions