ValueChange Class
+ + + + +Provides the implementation for the synthetic valuechange event. This class
+isn't meant to be used directly, but is public to make monkeypatching possible.
Usage:
+ +YUI().use('event-valuechange', function (Y) {
+ Y.one('#my-input').on('valuechange', function (e) {
+ Y.log('previous value: ' + e.prevVal);
+ Y.log('new value: ' + e.newVal);
+ });
+});
+
+-
+
- Index + + +
- Methods + + +
- Properties + + + +
Item Index
+ + +Methods
+ +-
+
+
- + _onBlur + + + static + + + + +
- + _onFocus + + + static + + + + +
- + _onKeyDown + + + static + + + + +
- + _onKeyUp + + + static + + + + +
- + _onMouseDown + + + static + + + + +
- + _onSubscribe + + + static + + + + +
- + _onUnsubscribe + + + static + + + + +
- + _poll + + + static + + + + +
- + _refreshTimeout + + + static + + + + +
- + _startPolling + + + static + + + + +
- + _stopPolling + + + static + + + + +
- + _stopTimeout + + + static + + + + +
Properties
+ +-
+
+
- + POLL_INTERVAL + + + static + + + + +
- + TIMEOUT + + + static + + + + +
Methods
+ + +_onBlur
+
+
+ -
+
+
-
+
+
e+ +
+
+ -
+
+
notifier+ +
+
+
Stops polling when a node's blur event fires.
+Parameters:
+ +-
+
+
-
+
+
e+ EventFacade + + + + ++ ++ + +
+
+ -
+
+
notifier+ SyntheticEvent.Notifier + + + + ++ ++ + +
+
+
_onFocus
+
+
+ -
+
+
-
+
+
e+ +
+
+ -
+
+
notifier+ +
+
+
Resets a node's history and starts polling when a focus event occurs.
+Parameters:
+ +-
+
+
-
+
+
e+ EventFacade + + + + ++ ++ + +
+
+ -
+
+
notifier+ SyntheticEvent.Notifier + + + + ++ ++ + +
+
+
_onKeyDown
+
+
+ -
+
+
-
+
+
e+ +
+
+ -
+
+
notifier+ +
+
+
Starts polling when a node receives a keyDown event.
+Parameters:
+ +-
+
+
-
+
+
e+ EventFacade + + + + ++ ++ + +
+
+ -
+
+
notifier+ SyntheticEvent.Notifier + + + + ++ ++ + +
+
+
_onKeyUp
+
+
+ -
+
+
-
+
+
e+ +
+
+ -
+
+
notifier+ +
+
+
Starts polling when an IME-related keyUp event occurs on a node.
+Parameters:
+ +-
+
+
-
+
+
e+ EventFacade + + + + ++ ++ + +
+
+ -
+
+
notifier+ SyntheticEvent.Notifier + + + + ++ ++ + +
+
+
_onMouseDown
+
+
+ -
+
+
-
+
+
e+ +
+
+ -
+
+
notifier+ +
+
+
Starts polling when a node receives a mouseDown event.
+Parameters:
+ +-
+
+
-
+
+
e+ EventFacade + + + + ++ ++ + +
+
+ -
+
+
notifier+ SyntheticEvent.Notifier + + + + ++ ++ + +
+
+
_onSubscribe
+
+
+ -
+
+
-
+
+
node+ +
+
+ -
+
+
sub+ +
+
+ -
+
+
notifier+ +
+
+ -
+
+
[filter]+ +
+
+
Called when the valuechange event receives a new subscriber.
Parameters:
+ +-
+
+
-
+
+
node+ Node + + + + ++ ++ + +
+
+ -
+
+
sub+ Subscription + + + + ++ ++ + +
+
+ -
+
+
notifier+ SyntheticEvent.Notifier + + + + ++ ++ + +
+
+ -
+
+
[filter]+ Function | String + optional + + + + +++ + +Filter function or selector string. Only + provided for delegate subscriptions.
+
+
+
_onUnsubscribe
+
+
+ -
+
+
-
+
+
node+ +
+
+ -
+
+
subscription+ +
+
+ -
+
+
notifier+ +
+
+
Called when the valuechange event loses a subscriber.
Parameters:
+ +-
+
+
-
+
+
node+ Node + + + + ++ ++ + +
+
+ -
+
+
subscription+ Subscription + + + + ++ ++ + +
+
+ -
+
+
notifier+ SyntheticEvent.Notifier + + + + ++ ++ + +
+
+
_poll
+
+
+ -
+
+
-
+
+
node+ +
+
+ -
+
+
options+ +
+
+
Called at an interval to poll for changes to the value of the specified +node.
+Parameters:
+ +-
+
+
-
+
+
node+ Node + + + + +++ + +Node to poll.
+
+
+ -
+
+
options+ Object + + + + +++ + +Options object.
+-
+
+
-
+
+
[e]+ EventFacade + optional + + +++ + +Event facade of the event that + initiated the polling.
+
+
+
+
+ -
+
+
_refreshTimeout
+
+
+ -
+
+
-
+
+
node+ +
+
+ -
+
+
notifier+ +
+
+
Restarts the inactivity timeout for the specified node.
+Parameters:
+ +-
+
+
-
+
+
node+ Node + + + + +++ + +Node to refresh.
+
+
+ -
+
+
notifier+ SyntheticEvent.Notifier + + + + ++ ++ + +
+
+
_startPolling
+
+
+ -
+
+
-
+
+
node+ +
+
+ -
+
+
notifier+ +
+
+ -
+
+
options+ +
+
+
Begins polling for changes to the value property of the specified node. If
+polling is already underway for the specified node, it will not be restarted
+unless the force option is true
Parameters:
+ +-
+
+
-
+
+
node+ Node + + + + +++ + +Node to watch.
+
+
+ -
+
+
notifier+ SyntheticEvent.Notifier + + + + ++ ++ + +
+
+ -
+
+
options+ Object + + + + +++ + +Options object.
+-
+
+
-
+
+
[e]+ EventFacade + optional + + +++ + +Event facade of the event that + initiated the polling.
+
+
+ -
+
+
[force=false]+ Boolean + optional + + +++ + +If
+true, polling will be + restarted even if we're already polling this node.
+
+
+
+ -
+
+
_stopPolling
+
+
+ -
+
+
-
+
+
node+ +
+
+ -
+
+
[notifier]+ +
+
+
Stops polling for changes to the specified node's value attribute.
Parameters:
+ +-
+
+
-
+
+
node+ Node + + + + +++ + +Node to stop polling on.
+
+
+ -
+
+
[notifier]+ SyntheticEvent.Notifier + optional + + + + +++ + +Notifier to remove from the + node. If not specified, all notifiers will be removed.
+
+
+
_stopTimeout
+
+
+ -
+
+
-
+
+
node+ +
+
+
Clears the inactivity timeout for the specified node, if any.
+Parameters:
+ +-
+
+
-
+
+
node+ Node + + + + ++ ++ + +
+
+
Properties
+ + +POLL_INTERVAL
+ Number
+
+
+
+
+
+
+
+
+ static
+
+
+
+
+ Interval (in milliseconds) at which to poll for changes to the value of an
+element with one or more valuechange subscribers when the user is likely
+to be interacting with it.
Default: 50
+ + + + + +TIMEOUT
+ Number
+
+
+
+
+
+
+
+
+ static
+
+
+
+
+ Timeout (in milliseconds) after which to stop polling when there hasn't been +any new activity (keypresses, mouse clicks, etc.) on an element.
+Default: 10000
+ + + + + +