back to Overview

.onChange()

Registers a handler to be called whenever content of the list's input fields changes.
Web module only.

Syntax Variants

list.onChange(handler)
list.onChange(selector, handler)
list.onChange(handler, bubbleSelector)
list.onChange(selector, handler, bubbleSelector)

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.
handler
the callback function(newValue, index, ev) to invoke when the event has been triggered:
newValue
For text fields and selects the new value string. For checkboxes/radio buttons it is the boolean returned by checked.
index
The index of the target element in the Minified list .
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 handler to be called whenever content of the list's input fields changes. The handler is called in realtime and does not wait for the focus to change. Text fields, text areas, selects as well as checkboxes and radio buttons are supported. The handler is called with the new value as first argument. For selects the value is the first selected item, but the function will be called for every change. The value is boolean for checkbox/radio buttons and a string for all other types.

Please note that the handler may be called on the user's first interaction even without an actual content change. After that, the handler will only be called when the content actually changed.

On legacy IE platforms, onChange tries to report every change as soon as possible. When used with bubbling selector, some text changes may not be reported before the input loses focus. This is because there is no reliable event to report text changes that also supports bubbling.

Example

Creates a handler that writes the input's content into a text node:

$('#myField').onChange(function(newValue, index, ev) { $('#target').fill(newValue); });

See also..

  • on() provides low-level event registration.

Comments

comments powered by Disqus

back to Overview

Functions