#

API Docs for: 3.10.3
Show: Inherited Protected Private Deprecated

# ValueChange Class

Defined in: `event-valuechange/js/event-valuechange.js:18`
Module: event-valuechange

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`

)
protected static

Defined in `event-valuechange/js/event-valuechange.js:258`

Stops polling when a node's blur event fires.

#### Parameters:

- `e` EventFacade
- `notifier` SyntheticEvent.Notifier

### `_onFocus`

(

- `e`
- `notifier`

)
protected static

Defined in `event-valuechange/js/event-valuechange.js:271`

Resets a node's history and starts polling when a focus event occurs.

#### Parameters:

- `e` EventFacade
- `notifier` SyntheticEvent.Notifier

### `_onKeyDown`

(

- `e`
- `notifier`

)
protected static

Defined in `event-valuechange/js/event-valuechange.js:294`

Starts polling when a node receives a keyDown event.

#### Parameters:

- `e` EventFacade
- `notifier` SyntheticEvent.Notifier

### `_onKeyUp`

(

- `e`
- `notifier`

)
protected static

Defined in `event-valuechange/js/event-valuechange.js:307`

Starts polling when an IME-related keyUp event occurs on a node.

#### Parameters:

- `e` EventFacade
- `notifier` SyntheticEvent.Notifier

### `_onMouseDown`

(

- `e`
- `notifier`

)
protected static

Defined in `event-valuechange/js/event-valuechange.js:327`

Starts polling when a node receives a mouseDown event.

#### Parameters:

- `e` EventFacade
- `notifier` SyntheticEvent.Notifier

### `_onSubscribe`

(

- `node`
- `sub`
- `notifier`
- `[filter]`

)
protected static

Defined in `event-valuechange/js/event-valuechange.js:340`

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`

)
protected static

Defined in `event-valuechange/js/event-valuechange.js:402`

Called when the `valuechange` event loses a subscriber.

#### Parameters:

- `node` Node
- `subscription` Subscription
- `notifier` SyntheticEvent.Notifier

### `_poll`

(

- `node`
- `options`

)
protected static

Defined in `event-valuechange/js/event-valuechange.js:69`

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`

)
protected static

Defined in `event-valuechange/js/event-valuechange.js:117`

Restarts the inactivity timeout for the specified node.

#### Parameters:

- `node` Node

  Node to refresh.

- `notifier` SyntheticEvent.Notifier

### `_startPolling`

(

- `node`
- `notifier`
- `options`

)
protected static

Defined in `event-valuechange/js/event-valuechange.js:148`

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]`

)
protected static

Defined in `event-valuechange/js/event-valuechange.js:207`

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`

)
protected static

Defined in `event-valuechange/js/event-valuechange.js:241`

Clears the inactivity timeout for the specified node, if any.

#### Parameters:

- `node` Node

## Properties

### `POLL_INTERVAL`

Number static

Defined in `event-valuechange/js/event-valuechange.js:44`

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

Defined in `event-valuechange/js/event-valuechange.js:56`

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