Version 3.18.1
Show:

YUI Class

Defined in: yui/js/yui.js:16
Module: yui-base
Parent Module: yui

The YUI global namespace object. This is the constructor for all YUI instances.

This is a self-instantiable factory function, meaning you don't need to precede it with the new operator. You can invoke it directly like this:

YUI().use('*', function (Y) {
                // Y is a new YUI instance.
            });

But it also works like this:

var Y = YUI();

The YUI constructor accepts an optional config object, like this:

YUI({
                debug: true,
                combine: false
            }).use('node', function (Y) {
                // Y.Node is ready to use.
            });

See the API docs for the Config class for the complete list of supported configuration properties accepted by the YUI constuctor.

If a global YUI object is already defined, the existing YUI object will not be overwritten, to ensure that defined namespaces are preserved.

Each YUI instance has full custom event support, but only if the event system is available.

Constructor

YUI

(
  • [config]
)

Defined in yui/js/yui.js:16

Parameters:

  • [config] Object optional multiple

    Zero or more optional configuration objects. Config values are stored in the Y.config property. See the Config docs for the list of supported properties.

Methods

_afterConfig

() private

Defined in yui/js/yui.js:512

This method is called after all other configuration has been applied to the YUI instance.

_aggregateGroups

(
  • modules
)
Object private

Provided by the jsonp module.

Defined in loader/js/loader-pathogen-combohandler.js:117

Aggregate modules into groups with unique keys. The key is "$name+$version" for core and gallery groups, and just "$root" for all other groups.

Parameters:

  • modules Array

    A list of module meta.

Returns:

Object:

Aggregated groups of module meta.

_attach

(
  • r
  • [moot=false]
)
private

Defined in yui/js/yui.js:680

Executes the callback function associated with each required module, attaching the module to this YUI instance.

Parameters:

  • r Array

    The array of modules to attach

  • [moot=false] Boolean optional

    If true, don't throw a warning if the module is not attached.

_buildCombo

(
  • groups
  • comboBase
  • comboTail
)
String private

Provided by the jsonp module.

Defined in loader/js/loader-pathogen-combohandler.js:209

Build each combo url from the bottom up. There's probably room for optimization here, but let's keep it simple for now.

Parameters:

  • groups Array

    Grouped module meta.

  • comboBase String

    The base of the combo url.

  • comboTail String

    The tail of the combo url (e.g. .debug.js).

Returns:

String:

A combo url.

_config

(
  • o
)
private

Defined in yui/js/yui.js:311

Old way to apply a config to this instance (calls applyConfig under the hood).

Parameters:

  • o Object

    The config to apply

_customResolve

(
  • modules
  • type
)
String private

Provided by the jsonp module.

Defined in loader/js/loader-pathogen-combohandler.js:80

Build each combo url from the bottom up. There's probably room for optimization here, but let's keep it simple for now.

Parameters:

  • modules Array

    A list of module meta.

  • type String

    Either js or css.

Returns:

String:

Combo url.

_delayCallback

(
  • cb
  • until
)
Function private

Defined in yui/js/yui.js:886

Delays the use callback until another event has taken place such as window.onload, domready, contentready, or available.

Parameters:

  • cb Function

    The original use callback.

  • until String | Object

    Either an event name ('load', 'domready', etc.) or an object containing event/args keys for contentready/available.

Returns:

_getFullType

(
  • type
)
String private

Returns the fully qualified type, given a short type string. That is, returns "foo:bar" when given "bar" if "foo" is the configured prefix.

NOTE: This method, unlike _getType, does no checking of the value passed in, and is designed to be used with the low level _publish() method, for critical path implementations which need to fast-track publish for performance reasons.

Parameters:

  • type String

    The short type to prefix

Returns:

String:

The prefixed type, if a prefix is set, otherwise the type passed in

_getLoadHook

(
  • data
  • path
)
private

Defined in yui/js/yui.js:1653

Load hook for Y.Get.script in Node.js, see YUI.setLoadHook

Parameters:

  • data String

    The content of the file

  • path String

    The file path of the file

_getType

() private

If the instance has a prefix attribute and the event type is not prefixed, the instance prefix is applied to the supplied type.

_hasPotentialSubscribers

(
  • fullType
)
Boolean private

Parameters:

  • fullType String

    The fully prefixed type name

Returns:

Boolean:

Whether the event has potential subscribers or not

_init

() private

Defined in yui/js/yui.js:323

Initializes this YUI instance.

_monitor

(
  • what
  • eventType
  • o
)
private

This is the entry point for the event monitoring system. You can monitor 'attach', 'detach', 'fire', and 'publish'. When configured, these events generate an event. click -> click_attach, click_detach, click_publish -- these can be subscribed to like other events to monitor the event system. Inividual published events can have monitoring turned on or off (publish can't be turned off before it it published) by setting the events 'monitor' config.

Parameters:

  • what String

    'attach', 'detach', 'fire', or 'publish'

  • eventType String | CustomEvent

    The prefixed name of the event being monitored, or the CustomEvent object.

  • o Object

    Information about the event interaction, such as fire() args, subscription category, publish config

_notify

(
  • callback
  • response
  • args
)
private

Defined in yui/js/yui.js:1096

Handles Loader notifications about attachment/load errors.

Parameters:

  • callback Function

    Callback to pass to Y.config.loadErrorFn.

  • response Object

    Response returned from Loader.

  • args Array

    Arguments passed from Loader.

_parseType

() private

Returns an array with the detach key (if provided), and the prefixed event name from _getType Y.on('detachcategory| menu:click', fn)

_pathogenEncodeComboSources

(
  • resolved
)
private

Provided by the jsonp module.

Defined in loader/js/loader-pathogen-combohandler.js:13

Encodes combo urls based on modules and appends them to an object hash of arrays from loader.resolve.

Parameters:

  • resolved Object

    The object hash of arrays in which to attach the encoded combo sources.

Returns:

Object

_publish

(
  • fullType
  • etOpts
  • ceOpts
)
CustomEvent private

The low level event publish implementation. It expects all the massaging to have been done outside of this method. e.g. the type to fullType conversion. It's designed to be a fast path publish, which can be used by critical code paths to improve performance.

Parameters:

  • fullType String

    The prefixed type of the event to publish.

  • etOpts Object

    The EventTarget specific configuration to mix into the published event.

  • ceOpts Object

    The publish specific configuration to mix into the published event.

Returns:

CustomEvent:

The published event. If called without etOpts or ceOpts, this will be the default CustomEvent instance, and can be configured independently.

_setup

() private

Defined in yui/js/yui.js:531

Finishes the instance setup. Attaches whatever YUI modules were defined at the time that this instance was created.

_sortAggregatedGroups

(
  • groups
)
Array private

Provided by the jsonp module.

Defined in loader/js/loader-pathogen-combohandler.js:273

Sort the aggregated groups, and the modules within them. Minimizes cache misses in Yahoo's infrastructure by encoding predictable combo urls across browsers since iterating over an object does not guarantee order.

Parameters:

  • groups Object

    Aggregated groups.

Returns:

Array:

Sorted groups.

_use

(
  • args
  • [callback]
)
private

Defined in yui/js/yui.js:1125

Called from the use method queue to ensure that only one set of loading logic is performed at a time.

Parameters:

  • args String multiple

    One or more modules to attach.

  • [callback] Function optional

    Function to call once all required modules have been attached.

add

(
  • name
  • fn
  • version
  • [details]
)
YUI

Defined in yui/js/yui.js:595

Registers a YUI module and makes it available for use in a YUI().use() call or as a dependency for other modules.

The easiest way to create a first-class YUI module is to use Shifter, the YUI component build tool.

Shifter will automatically wrap your module code in a YUI.add() call along with any configuration info required for the module.

Parameters:

  • name String

    Module name.

  • fn Function

    Function containing module code. This function will be executed whenever the module is attached to a specific YUI instance.

    • Y YUI

      The YUI instance to which this module is attached.

    • name String

      Name of the module

  • version String

    Module version number. This is currently used only for informational purposes, and is not used internally by YUI.

  • [details] Object optional

    Module config.

    • [requires] Array optional

      Array of other module names that must be attached before this module can be attached.

    • [optional] Array optional

      Array of optional module names that should be attached before this module is attached if they've already been loaded. If the loadOptional YUI option is true, optional modules that have not yet been loaded will be loaded just as if they were hard requirements.

    • [use] Array optional

      Array of module names that are included within or otherwise provided by this module, and which should be attached automatically when this module is attached. This makes it possible to create "virtual rollup" modules that simply attach a collection of other modules or submodules.

Returns:

YUI:

This YUI instance.

Example:

YUI.add('davglass', function (Y) {
                Y.davglass = function () {
                    Y.log('Dav was here!');
                };
            }, '3.4.0', {
                requires: ['harley-davidson', 'mt-dew']
            });

addTarget

(
  • o
)
chainable

Registers another EventTarget as a bubble target. Bubble order is determined by the order registered. Multiple targets can be specified.

Events can only bubble if emitFacade is true.

Included in the event-custom-complex submodule.

Parameters:

after

(
  • type
  • fn
  • [context]
  • [args*]
)
EventHandle

Inherited from EventTarget but overwritten in event-custom/js/event-target.js:988

Like on(), this method creates a subscription to a custom event or to the execution of a method on an object.

For events, after() subscribers are executed after the event's defaultFn unless e.preventDefault() was called from an on() subscriber.

See the on() method for additional subscription options.

NOTE: The subscription signature shown is for events, not for function injection. See Y.Do.after for that signature.

Parameters:

  • type String

    The custom event name

  • fn Function

    The callback to execute in response to the event

  • [context] Object optional

    Override this object in callback

  • [args*] Any optional

    0..n additional arguments to supply to the subscriber

Returns:

EventHandle:

A subscription handle capable of detaching the subscription

aggregate

(
  • receiver
  • supplier
  • [overwrite=false]
  • [whitelist]
)
Object

Provided by the oop module.

Defined in oop/js/oop.js:162

Copies object properties from the supplier to the receiver. If the target has the property, and the property is an object, the target object will be augmented with the supplier's value.

Parameters:

  • receiver Object

    Object to receive the augmentation.

  • supplier Object

    Object that supplies the properties with which to augment the receiver.

  • [overwrite=false] Boolean optional

    If true, properties already on the receiver will be overwritten if found on the supplier.

  • [whitelist] String[] optional

    Whitelist. If supplied, only properties in this list will be applied to the receiver.

Returns:

Object:

Augmented object.

all

(
  • selector
)
NodeList

Provided by the node-core module.

Defined in node/js/node-core.js:243

Retrieves a NodeList based on the given CSS selector.

Parameters:

  • selector String

    The CSS selector to test against.

Returns:

NodeList:

A NodeList instance for the matching HTMLCollection/Array.

applyConfig

(
  • o
)
static

Defined in yui/js/yui.js:1566

Available since 3.5.0

Applies a configuration to all YUI instances in this execution context.

The main use case for this method is in "mashups" where several third-party scripts need to write to a global YUI config, but cannot share a single centrally-managed config object. This way they can all call YUI.applyConfig({}) instead of overwriting the single global config.

Parameters:

  • o Object

    Configuration object to apply.

Example:

YUI.applyConfig({
                modules: {
                    davglass: {
                        fullpath: './davglass.js'
                    }
                }
            });
            
            YUI.applyConfig({
                modules: {
                    foo: {
                        fullpath: './foo.js'
                    }
                }
            });
            
            YUI().use('davglass', function (Y) {
                // Module davglass will be available here.
            });

applyConfig

(
  • o
)

Defined in yui/js/yui.js:263

Available since 3.2.0

Applies a new configuration object to the config of this YUI instance. This will merge new group/module definitions, and will also update the loader cache if necessary. Updating Y.config directly will not update the cache.

Parameters:

  • o Object

    the configuration object.

applyTo

(
  • id
  • method
  • args
)
Mixed

Defined in yui/js/yui.js:561

Executes the named method on the specified YUI instance if that method is whitelisted.

Parameters:

  • id String

    YUI instance id.

  • method String

    Name of the method to execute. For example: 'Object.keys'.

  • args Array

    Arguments to apply to the method.

Returns:

Mixed:

Return value from the applied method, or null if the specified instance was not found or the method was not whitelisted.

assert

(
  • condition
  • message
)
static

Provided by the test module.

Defined in test/js/YTestWrapAfter.js:29

Asserts that a given condition is true. If not, then a Y.Assert.Error object is thrown and the test fails.

Parameters:

  • condition Boolean

    The condition to test.

  • message String

    The message to display if the assertion fails.

augment

(
  • receiver
  • supplier
  • [overwrite=false]
  • [whitelist]
  • [args]
)
Function

Provided by the oop module.

Defined in oop/js/oop.js:56

Augments the receiver with prototype properties from the supplier. The receiver may be a constructor function or an object. The supplier must be a constructor function.

If the receiver is an object, then the supplier constructor will be called immediately after receiver is augmented, with receiver as the this object.

If the receiver is a constructor function, then all prototype methods of supplier that are copied to receiver will be sequestered, and the supplier constructor will not be called immediately. The first time any sequestered method is called on the receiver's prototype, all sequestered methods will be immediately copied to the receiver's prototype, the supplier's constructor will be executed, and finally the newly unsequestered method that was called will be executed.

This sequestering logic sounds like a bunch of complicated voodoo, but it makes it cheap to perform frequent augmentation by ensuring that suppliers' constructors are only called if a supplied method is actually used. If none of the supplied methods is ever used, then there's no need to take the performance hit of calling the supplier's constructor.

Parameters:

  • receiver Function | Object

    Object or function to be augmented.

  • supplier Function

    Function that supplies the prototype properties with which to augment the receiver.

  • [overwrite=false] Boolean optional

    If true, properties already on the receiver will be overwritten if found on the supplier's prototype.

  • [whitelist] String[] optional

    An array of property names. If specified, only the whitelisted prototype properties will be applied to the receiver, and all others will be ignored.

  • [args] Array | Any optional

    Argument or array of arguments to pass to the supplier's constructor when initializing.

Returns:

Function:

Augmented object.

batch

(
  • operation
)
Promise

Provided by the pluginhost-base module.

Defined in promise/js/batch.js:1

Returns a new promise that will be resolved when all operations have completed. Takes both any numer of values as arguments. If an argument is a not a promise, it will be wrapped in a new promise, same as in Y.when().

Parameters:

  • operation Any multiple

    Any number of Y.Promise objects or regular JS values

Returns:

Promise:

Promise to be fulfilled when all provided promises are resolved

before

()

Executes the callback before a DOM event, custom event or method. If the first argument is a function, it is assumed the target is a method. For DOM and custom events, this is an alias for Y.on.

For DOM and custom events: type, callback, context, 0-n arguments

For methods: callback, object (method host), methodName, context, 0-n arguments

Returns:

detach handle

bind

(
  • f
  • c
  • args
)
Function

Provided by the oop module.

Defined in oop/js/oop.js:380

Returns a function that will execute the supplied function in the supplied object's context, optionally adding any additional supplied parameters to the beginning of the arguments collection the supplied to the function.

Parameters:

  • f Function | String

    the function to bind, or a function name to execute on the context object.

  • c Object

    the execution context.

  • args Any multiple

    0..n arguments to include before the arguments the function is executed with.

Returns:

Function:

the wrapped function.

bubble

(
  • evt
)
Boolean

Propagate an event. Requires the event-custom-complex module.

Parameters:

Returns:

Boolean:

the aggregated return value from Event.Custom.fire

cached

(
  • source
  • [cache={}]
  • [refetch]
)
Function

Returns a wrapper for a function which caches the return value of that function, keyed off of the combined string representation of the argument values provided when the wrapper is called.

Calling this function again with the same arguments will return the cached value rather than executing the wrapped function.

Note that since the cache is keyed off of the string representation of arguments passed to the wrapper function, arguments that aren't strings and don't provide a meaningful toString() method may result in unexpected caching behavior. For example, the objects {} and {foo: 'bar'} would both be converted to the string [object Object] when used as a cache key.

Parameters:

  • source Function

    The function to memoize.

  • [cache={}] Object optional

    Object in which to store cached values. You may seed this object with pre-existing cached values if desired.

  • [refetch] Any optional

    If supplied, this value is compared with the cached value using a == comparison. If the values are equal, the wrapped function is executed again even though a cached value exists.

Returns:

Function:

Wrapped function.

clone

(
  • o
  • safe
  • f
  • c
  • owner
  • cloned
)
Array | Object

Provided by the oop module.

Defined in oop/js/oop.js:258

Deep object/array copy. Function clones are actually wrappers around the original function. Array-like objects are treated as arrays. Primitives are returned untouched. Optionally, a function can be provided to handle other data types, filter keys, validate values, etc.

Note: Cloning a non-trivial object is a reasonably heavy operation, due to the need to recursively iterate down non-primitive properties. Clone should be used only when a deep clone down to leaf level properties is explicitly required. This method will also

In many cases (for example, when trying to isolate objects used as hashes for configuration properties), a shallow copy, using Y.merge() is normally sufficient. If more than one level of isolation is required, Y.merge() can be used selectively at each level which needs to be isolated from the original without going all the way to leaf properties.

Parameters:

  • o Object

    what to clone.

  • safe Boolean

    if true, objects will not have prototype items from the source. If false, they will. In this case, the original is initially protected, but the clone is not completely immune from changes to the source object prototype. Also, cloned prototype items that are deleted from the clone will result in the value of the source prototype being exposed. If operating on a non-safe clone, items should be nulled out rather than deleted.

  • f Function

    optional function to apply to each item in a collection; it will be executed prior to applying the value to the new object. Return false to prevent the copy.

  • c Object

    optional execution context for f.

  • owner Object

    Owner object passed when clone is iterating an object. Used to set up context for cloned functions.

  • cloned Object

    hash of previously cloned objects to avoid multiple clones.

Returns:

Array | Object:

the cloned object.

delegate

(
  • type
  • fn
  • el
  • filter
  • context
  • args
)
EventHandle

Provided by the event-delegate module.

Defined in event/js/delegate.js:311

Sets up event delegation on a container element. The delegated event will use a supplied filter to test if the callback should be executed. This filter can be either a selector string or a function that returns a Node to use as the currentTarget for the event.

The event object for the delegated event is supplied to the callback function. It is modified slightly in order to support all properties that may be needed for event delegation. 'currentTarget' is set to the element that matched the selector string filter or the Node returned from the filter function. 'container' is set to the element that the listener is delegated from (this normally would be the 'currentTarget').

Filter functions will be called with the arguments that would be passed to the callback function, including the event object as the first parameter. The function should return false (or a falsey value) if the success criteria aren't met, and the Node to use as the event's currentTarget and 'this' object if they are.

Parameters:

  • type String

    the event type to delegate

  • fn Function

    the callback function to execute. This function will be provided the event object for the delegated event.

  • el String | Node

    the element that is the delegation container

  • filter String | Function

    a selector that must match the target of the event or a function that returns a Node or false.

  • context Object

    optional argument that specifies what 'this' refers to.

  • args Object multiple

    0..n additional arguments to pass on to the callback function. These arguments will be added after the event object.

Returns:

EventHandle:

the detach handle

destroy

()

Defined in yui/js/yui.js:1527

Available since 3.3.0

Destroys this YUI instance.

detach

(
  • type
  • fn
  • context
)
EventTarget

Detach one or more listeners the from the specified event

Parameters:

  • type String | Object

    Either the handle to the subscriber or the type of event. If the type is not specified, it will attempt to remove the listener from all hosted events.

  • fn Function

    The subscribed function to unsubscribe, if not supplied, all subscribers will be removed.

  • context Object

    The custom object passed to subscribe. This is optional, but if supplied will be used to disambiguate multiple listeners that are the same (e.g., you subscribe many object using a function that lives on the prototype)

Returns:

EventTarget:

the host

detachAll

(
  • type
)

Removes all listeners from the specified event. If the event type is not specified, all listeners from all hosted custom events will be removed.

Parameters:

  • type String

    The type, or name of the event

dispatch

(
  • o
  • f
  • c
  • proto
  • action
)
Mixed private

Provided by the oop module.

Defined in oop/js/oop.js:16

Calls the specified action method on o if it exists. Otherwise, if o is an array, calls the action method on Y.Array, or if o is an object, calls the action method on Y.Object.

If o is an array-like object, it will be coerced to an array.

This is intended to be used with array/object iteration methods that share signatures, such as each(), some(), etc.

Parameters:

  • o Object

    Array or object to dispatch to.

  • f Function

    Iteration callback.

    • value Mixed

      Value being iterated.

    • key Mixed

      Current object key or array index.

    • object Mixed

      Object or array being iterated.

  • c Object

    this object to bind the iteration callback to.

  • proto Boolean

    If true, prototype properties of objects will be iterated.

  • action String

    Function name to be dispatched on o. For example: 'some', 'each', etc.

Returns:

Mixed:

Returns the value returned by the chosen iteration action, which varies.

dump

(
  • o
  • d
)
String

Provided by the dump module.

Defined in dump/js/dump.js:18

Returns a simple string representation of the object or array. Other types of objects will be returned unprocessed. Arrays are expected to be indexed.

Parameters:

  • o Object

    The object to dump.

  • d Number

    How deep to recurse child objects, default 3.

Returns:

String:

the dump result.

each

(
  • o
  • f
  • c
  • proto
)
YUI

Provided by the oop module.

Defined in oop/js/oop.js:222

Executes the supplied function for each item in a collection. Supports arrays, objects, and NodeLists

Parameters:

  • o Object

    the object to iterate.

  • f Function

    the function to execute. This function receives the value, key, and object as parameters.

  • c Object

    the execution context for the function.

  • proto Boolean

    if true, prototype properties are iterated on objects.

Returns:

YUI:

the YUI instance.

error

(
  • msg
  • [e]
  • [src]
)
chainable

Defined in yui/js/yui.js:1435

Reports an error.

The reporting mechanism is controlled by the throwFail configuration attribute. If throwFail is falsy, the message is logged. If throwFail is truthy, a JS exception is thrown.

If an errorFn is specified in the config it must return true to indicate that the exception was handled and keep it from being thrown.

Parameters:

  • msg String

    Error message.

  • [e] Error | String optional

    JavaScript error object or an error string.

  • [src] String optional

    Source of the error (such as the name of the module in which the error occurred).

extend

(
  • r
  • s
  • px
  • sx
)
Object

Provided by the oop module.

Defined in oop/js/oop.js:181

Utility to set up the prototype, constructor and superclass properties to support an inheritance strategy that can chain constructors and methods. Static members will not be inherited.

Parameters:

  • r Function

    the object to modify.

  • s Function

    the object to inherit.

  • px Object

    prototype properties to add/override.

  • sx Object

    static properties to add/override.

Returns:

Object:

the extended object.

fail

(
  • message
)
static

Provided by the test module.

Defined in test/js/YTestWrapAfter.js:45

Forces an assertion error to occur. Shortcut for Y.Assert.fail().

Parameters:

  • message String

    (Optional) The message to display with the failure.

fire

(
  • type
  • arguments
)
Boolean

Fire a custom event by name. The callback functions will be executed from the context specified when the event was created, and with the following parameters.

The first argument is the event type, and any additional arguments are passed to the listeners as parameters. If the first of these is an object literal, and the event is configured to emit an event facade, that object is mixed into the event facade and the facade is provided in place of the original object.

If the custom event object hasn't been created, then the event hasn't been published and it has no subscribers. For performance sake, we immediate exit in this case. This means the event won't bubble, so if the intention is that a bubble target be notified, the event must be published on this object first.

Parameters:

  • type String | Object

    The type of the event, or an object that contains a 'type' property.

  • arguments Object*

    an arbitrary set of parameters to pass to the handler. If the first of these is an object literal and the event is configured to emit an event facade, the event facade will replace that parameter after the properties the object literal contains are copied to the event facade.

Returns:

Boolean:

True if the whole lifecycle of the event went through, false if at any point the event propagation was halted.

getEvent

(
  • type
  • prefixed
)
CustomEvent

Returns the custom event of the provided type has been created, a falsy value otherwise

Parameters:

  • type String

    the type, or name of the event

  • prefixed String

    if true, the type is prefixed already

Returns:

CustomEvent:

the custom event or null

getLocation

() Location

Defined in yui/js/yui-core.js:57

Available since 3.5.0

Returns the location object from the window/frame in which this YUI instance operates, or undefined when executing in a non-browser environment (e.g. Node.js).

It is not recommended to hold references to the window.location object outside of the scope of a function in which its properties are being accessed or its methods are being called. This is because of a nasty bug/issue that exists in both Safari and MobileSafari browsers: WebKit Bug 34679.

Returns:

Location:

The location object from the window/frame in which this YUI instance operates.

getTargets

()

Returns an array of bubble targets for this object.

Returns:

EventTarget[]

guid

(
  • [pre]
)
String

Defined in yui/js/yui.js:1470

Generates an id string that is unique among all YUI instances in this execution context.

Parameters:

  • [pre] String optional

    Prefix.

Returns:

String:

Unique id.

header

(
  • name
  • value
)
static

Provided by the io-base module.

Defined in io/js/io-base.js:940

Method for setting and deleting IO HTTP headers to be sent with every request.

Hosted as a property on the io function (e.g. Y.io.header).

Parameters:

instanceOf

(
  • o
  • type
)

Defined in yui/js/yui.js:1543

Available since 3.3.0

Safe instanceof wrapper that works around a memory leak in IE when the object being tested is window or document.

Unless you are testing objects that may be window or document, you should use the native instanceof operator instead of this method.

Parameters:

  • o Object

    Object to check.

  • type Object

    Class to check against.

io

(
  • url
  • config
)
Object static

Provided by the io-base module.

Defined in io/js/io-base.js:809

Method for initiating an ajax call. The first argument is the url end point for the call. The second argument is an object to configure the transaction and attach event subscriptions. The configuration object supports the following properties:

method
HTTP method verb (e.g., GET or POST). If this property is not not defined, the default value will be GET.
data
This is the name-value string that will be sent as the transaction data. If the request is HTTP GET, the data become part of querystring. If HTTP POST, the data are sent in the message body.
xdr
Defines the transport to be used for cross-domain requests. By setting this property, the transaction will use the specified transport instead of XMLHttpRequest. The properties of the transport object are:
use
The transport to be used: 'flash' or 'native'
dataType
Set the value to 'XML' if that is the expected response content type.
form
Form serialization configuration object. Its properties are:
id
Node object or id of HTML form
useDisabled
true to also serialize disabled form field values (defaults to false)
on
Assigns transaction event subscriptions. Available events are:
start
Fires when a request is sent to a resource.
complete
Fires when the transaction is complete.
success
Fires when the HTTP response status is within the 2xx range.
failure
Fires when the HTTP response status is outside the 2xx range, if an exception occurs, if the transation is aborted, or if the transaction exceeds a configured timeout.
end
Fires at the conclusion of the transaction lifecycle, after success or failure.
<p>Callback functions for start and end receive the id of the
            transaction as a first argument. For complete, success, and
            failure, callbacks receive the id and the response object
            (usually the XMLHttpRequest instance).  If the arguments
            property was included in the configuration object passed to
            Y.io(), the configured data will be passed to all callbacks as
            the last argument.</p>
            </dd>

sync
Pass true to make a same-domain transaction synchronous. CAVEAT: This will negatively impact the user experience. Have a very good reason if you intend to use this.

context
The "this'" object for all configured event handlers. If a specific context is needed for individual callbacks, bind the callback to a context usingY.bind()`.

headers
Object map of transaction headers to send to the server. The object keys are the header names and the values are the header values.

timeout
Millisecond threshold for the transaction before being automatically aborted.

arguments
User-defined data passed to all registered event handlers. This value is available as the second argument in the "start" and "end" event handlers. It is the third argument in the "complete", "success", and "failure" event handlers. Be sure to quote this property name in the transaction configuration as "arguments" is a reserved word in JavaScript (e.g. Y.io({ ..., "arguments": stuff })).

Parameters:

  • url String

    qualified path to transaction resource.

  • config Object

    configuration object for the transaction.

Returns:

Object:

An object containing:

id
The transaction ID for this request.
abort
A function to abort the current transaction.
isInProgress
A helper to determine whether the current transaction is in progress.
io
A reference to the IO object for this transaction.

jsonp

(
  • url
  • c
  • args
)
JSONPRequest static

Provided by the jsonp module.

Defined in jsonp/js/jsonp.js:250

Parameters:

  • url String

    the url of the JSONP service with the {callback} placeholder where the callback function name typically goes.

  • c Function | Object

    Callback function accepting the JSON payload as its argument, or a configuration object (see above).

  • args Any multiple

    additional arguments to pass to send()

Returns:

later

(
  • when
  • o
  • fn
  • data
  • periodic
)
Object

Provided by the yui-later module.

Defined in yui/js/yui-later.js:11

Executes the supplied function in the context of the supplied object 'when' milliseconds later. Executes the function a single time unless periodic is set to true.

Parameters:

  • when Number

    the number of milliseconds to wait until the fn is executed.

  • o Object

    the context object.

  • fn Function | String

    the function to execute or the name of the method in the 'o' object to execute.

  • data Object

    [Array] data that is provided to the function. This accepts either a single item or an array. If an array is provided, the function is executed with one parameter for each array item. If you need to pass a single array parameter, it needs to be wrapped in an array [myarray].

    Note: native methods in IE may not have the call and apply methods. In this case, it will work, but you are limited to four arguments.

  • periodic Boolean

    if true, executes continuously at supplied interval until canceled.

Returns:

Object:

a timer object. Call the cancel() method on this object to stop the timer.

log

(
  • msg
  • cat
  • src
  • silent
)
YUI

Provided by the yui-log module.

Defined in yui/js/yui-log.js:18

If the 'debug' config is true, a 'yui:log' event will be dispatched, which the Console widget and anything else can consume. If the 'useBrowserConsole' config is true, it will write to the browser console if available. YUI-specific log messages will only be present in the -debug versions of the JS files. The build system is supposed to remove log statements from the raw and minified versions of the files.

Parameters:

  • msg String

    The message to log.

  • cat String

    The log category for the message. Default categories are "info", "warn", "error", "debug". Custom categories can be used as well. (opt).

  • src String

    The source of the the message (opt).

  • silent Boolean

    If true, the log event won't fire.

Returns:

YUI:

YUI instance.

merge

(
  • objects
)
Object

Returns a new object containing all of the properties of all the supplied objects. The properties from later objects will overwrite those in earlier objects.

Passing in a single object will create a shallow copy of it. For a deep copy, use clone().

Parameters:

  • objects Object multiple

    One or more objects to merge.

Returns:

Object:

A new merged object.

message

(
  • msg
  • cat
  • src
  • silent
)
YUI

Provided by the yui-log module.

Defined in yui/js/yui-log.js:105

Write a system message. This message will be preserved in the minified and raw versions of the YUI files, unlike log statements.

Parameters:

  • msg String

    The message to log.

  • cat String

    The log category for the message. Default categories are "info", "warn", "error", "debug". Custom categories can be used as well. (opt).

  • src String

    The source of the the message (opt).

  • silent Boolean

    If true, the log event won't fire.

Returns:

YUI:

YUI instance.

mix

(
  • receiver
  • supplier
  • [overwrite=false]
  • [whitelist]
  • [mode=0]
  • [merge=false]
)
Function | Object | YUI

Mixes supplier's properties into receiver.

Properties on receiver or receiver's prototype will not be overwritten or shadowed unless the overwrite parameter is true, and will not be merged unless the merge parameter is true.

In the default mode (0), only properties the supplier owns are copied (prototype properties are not copied). The following copying modes are available:

  • 0: Default. Object to object.
  • 1: Prototype to prototype.
  • 2: Prototype to prototype and object to object.
  • 3: Prototype to object.
  • 4: Object to prototype.

Parameters:

  • receiver Function | Object

    The object or function to receive the mixed properties.

  • supplier Function | Object

    The object or function supplying the properties to be mixed.

  • [overwrite=false] Boolean optional

    If true, properties that already exist on the receiver will be overwritten with properties from the supplier.

  • [whitelist] String[] optional

    An array of property names to copy. If specified, only the whitelisted properties will be copied, and all others will be ignored.

  • [mode=0] Number optional

    Mix mode to use. See above for available modes.

  • [merge=false] Boolean optional

    If true, objects and arrays that already exist on the receiver will have the corresponding object/array from the supplier merged into them, rather than being skipped or overwritten. When both overwrite and merge are true, merge takes precedence.

Returns:

Function | Object | YUI:

The receiver, or the YUI instance if the specified receiver is falsy.

namespace

(
  • namespace
)
Object

Defined in yui/js/yui.js:1370

Utility method for safely creating namespaces if they don't already exist. May be called statically on the YUI global object or as a method on a YUI instance.

When called statically, a namespace will be created on the YUI global object:

// Create YUI.your.namespace.here as nested objects, preserving any
            // objects that already exist instead of overwriting them.
            YUI.namespace('your.namespace.here');

When called as a method on a YUI instance, a namespace will be created on that instance:

// Creates Y.property.package.
            Y.namespace('property.package');

Dots in the input string cause namespace to create nested objects for each token. If any part of the requested namespace already exists, the current object will be left in place and will not be overwritten. This allows multiple calls to namespace to preserve existing namespaced properties.

If the first token in the namespace string is "YAHOO", that token is discarded. This is legacy behavior for backwards compatibility with YUI 2.

Be careful with namespace tokens. Reserved words may work in some browsers and not others. For instance, the following will fail in some browsers because the supported version of JavaScript reserves the word "long":

Y.namespace('really.long.nested.namespace');

Note: If you pass multiple arguments to create multiple namespaces, only the last one created is returned from this function.

Parameters:

  • namespace String multiple

    One or more namespaces to create.

Returns:

Object:

Reference to the last namespace object created.

on

(
  • type
  • fn
  • [context]
  • [arg*]
)
EventHandle

Inherited from EventTarget but overwritten in event-custom/js/event-target.js:890

Y.on() can do many things:

  • Subscribe to custom events published and fired from Y
  • Subscribe to custom events published with broadcast 1 or 2 and fired from any object in the YUI instance sandbox
  • Subscribe to DOM events
  • Subscribe to the execution of a method on any object, effectively treating that method as an event

For custom event subscriptions, pass the custom event name as the first argument and callback as the second. The this object in the callback will be Y unless an override is passed as the third argument.

Y.on('io:complete', function () {
                Y.MyApp.updateStatus('Transaction complete');
            });

To subscribe to DOM events, pass the name of a DOM event as the first argument and a CSS selector string as the third argument after the callback function. Alternately, the third argument can be a Node, NodeList, HTMLElement, array, or simply omitted (the default is the window object).

Y.on('click', function (e) {
                e.preventDefault();
            
                // proceed with ajax form submission
                var url = this.get('action');
                ...
            }, '#my-form');

The this object in DOM event callbacks will be the Node targeted by the CSS selector or other identifier.

on() subscribers for DOM events or custom events published with a defaultFn can prevent the default behavior with e.preventDefault() from the event object passed as the first parameter to the subscription callback.

To subscribe to the execution of an object method, pass arguments corresponding to the call signature for Y.Do.before(...).

NOTE: The formal parameter list below is for events, not for function injection. See Y.Do.before for that signature.

Parameters:

  • type String

    DOM or custom event name

  • fn Function

    The callback to execute in response to the event

  • [context] Object optional

    Override this object in callback

  • [arg*] Any optional

    0..n additional arguments to supply to the subscriber

Returns:

EventHandle:

A subscription handle capable of detaching the subscription

once

(
  • type
  • fn
  • [context]
  • [arg*]
)
EventHandle

Inherited from EventTarget but overwritten in event-custom/js/event-target.js:947

Listen for an event one time. Equivalent to on(), except that the listener is immediately detached when executed.

See the on() method for additional subscription options.

Parameters:

  • type String

    DOM or custom event name

  • fn Function

    The callback to execute in response to the event

  • [context] Object optional

    Override this object in callback

  • [arg*] Any optional

    0..n additional arguments to supply to the subscriber

Returns:

EventHandle:

A subscription handle capable of detaching the subscription

onceAfter

(
  • type
  • fn
  • [context]
  • [arg*]
)
EventHandle

Inherited from EventTarget but overwritten in event-custom/js/event-target.js:965

Listen for an event one time. Equivalent to once(), except, like after(), the subscription callback executes after all on() subscribers and the event's defaultFn (if configured) have executed. Like after() if any on() phase subscriber calls e.preventDefault(), neither the defaultFn nor the after() subscribers will execute.

The listener is immediately detached when executed.

See the on() method for additional subscription options.

Parameters:

  • type String

    The custom event name

  • fn Function

    The callback to execute in response to the event

  • [context] Object optional

    Override this object in callback

  • [arg*] Any optional

    0..n additional arguments to supply to the subscriber

Returns:

EventHandle:

A subscription handle capable of detaching the subscription

one

(
  • node
)
Node | null

Provided by the node-core module.

Defined in node/js/node-core.js:252

Returns a single Node instance bound to the node or the first element matching the given selector. Returns null if no match found. Note: For chaining purposes you may want to use Y.all, which returns a NodeList when no match is found.

Parameters:

Returns:

Node | null:

a Node instance or null if no match found.

parseType

(
  • type
  • [pre]
)
Array

Inherited from EventTarget: event-custom/js/event-target.js:168

Available since 3.3.0

Takes the type parameter passed to 'on' and parses out the various pieces that could be included in the type. If the event type is passed without a prefix, it will be expanded to include the prefix one is supplied or the event target is configured with a default prefix.

Parameters:

  • type String

    the type

  • [pre] String optional

    The prefix. Defaults to this._yuievt.config.prefix

Returns:

Array:

an array containing:

  • the detach category, if supplied,
  • the prefixed event type,
  • whether or not this is an after listener,
  • the supplied event type

publish

(
  • type
  • opts
)
CustomEvent

Creates a new custom event of the specified type. If a custom event by that name already exists, it will not be re-created. In either case the custom event is returned.

Parameters:

  • type String

    the type, or name of the event

  • opts Object

    optional config params. Valid properties are:

    • [broadcast=false] Boolean optional

      whether or not the YUI instance and YUI global are notified when the event is fired.

    • [bubbles=true] Boolean optional

      Whether or not this event bubbles. Events can only bubble if emitFacade is true.

    • [context=this] Object optional

      the default execution context for the listeners.

    • [defaultFn] Function optional

      the default function to execute when this event fires if preventDefault was not called.

    • [emitFacade=false] Boolean optional

      whether or not this event emits a facade.

    • [prefix] String optional

      the prefix for this targets events, e.g., 'menu' in 'menu:click'.

    • [fireOnce=false] Boolean optional

      if an event is configured to fire once, new subscribers after the fire will be notified immediately.

    • [async=false] Boolean optional

      fireOnce event listeners will fire synchronously if the event has already fired unless async is true.

    • [preventable=true] Boolean optional

      whether or not preventDefault() has an effect.

    • [preventedFn] Function optional

      a function that is executed when preventDefault() is called.

    • [queuable=false] Boolean optional

      whether or not this event can be queued during bubbling.

    • [silent] Boolean optional

      if silent is true, debug messages are not provided for this event.

    • [stoppedFn] Function optional

      a function that is executed when stopPropagation is called.

    • [monitored] Boolean optional

      specifies whether or not this event should send notifications about when the event has been attached, detached, or published.

    • [type] String optional

      the event type (valid option if not provided as the first parameter to publish).

Returns:

CustomEvent:

the custom event

rbind

(
  • f
  • c
  • args
)
Function

Provided by the oop module.

Defined in oop/js/oop.js:405

Returns a function that will execute the supplied function in the supplied object's context, optionally adding any additional supplied parameters to the end of the arguments the function is executed with.

Parameters:

  • f Function | String

    the function to bind, or a function name to execute on the context object.

  • c Object

    the execution context.

  • args Any multiple

    0..n arguments to append to the end of arguments collection supplied to the function.

Returns:

Function:

the wrapped function.

removeTarget

(
  • o
)
chainable

Removes a bubble target

Parameters:

require

(
  • [modules*]
  • callback
)

Defined in yui/js/yui.js:1037

Sugar for loading both legacy and ES6-based YUI modules.

Parameters:

  • [modules*] String optional

    List of module names to import or a single module name.

  • callback Function

    Callback that gets called once all the modules were loaded. Each parameter of the callback is the export value of the corresponding module in the list. If the module is a legacy YUI module, the YUI instance is used instead of the module exports.

Example:

YUI().require(['es6-set'], function (Y, imports) {
                var Set = imports.Set,
                    set = new Set();
            });

setLoadHook

(
  • fn
)
static

Defined in yui/js/yui.js:1637

Set a method to be called when Get.script is called in Node.js Get will open the file, then pass it's content and it's path to this method before attaching it. Commonly used for code coverage instrumentation. Calling this multiple times will only attach the last hook method. This method is only available in Node.js.

Parameters:

  • fn Function

    The function to set

    • data String

      The content of the file

    • path String

      The file path of the file

some

(
  • o
  • f
  • c
  • proto
)
Boolean

Provided by the oop module.

Defined in oop/js/oop.js:239

Executes the supplied function for each item in a collection. The operation stops if the function returns true. Supports arrays, objects, and NodeLists.

Parameters:

  • o Object

    the object to iterate.

  • f Function

    the function to execute. This function receives the value, key, and object as parameters.

  • c Object

    the execution context for the function.

  • proto Boolean

    if true, prototype properties are iterated on objects.

Returns:

Boolean:

true if the function ever returns true, false otherwise.

soon

(
  • callbackFunction
)
Object

Provided by the timers module.

Defined in timers/js/epilogue.js:5

Y.soon accepts a callback function. The callback function will be called once in a future turn of the JavaScript event loop. If the function requires a specific execution context or arguments, wrap it with Y.bind. Y.soon returns an object with a cancel method. If the cancel method is called before the callback function, the callback function won't be called.

Parameters:

Returns:

Object:

An object with a cancel method. If the cancel method is called before the callback function, the callback function won't be called.

stamp

(
  • o
  • readOnly
)
String

Defined in yui/js/yui.js:1483

Returns a unique id associated with the given object and (if readOnly is falsy) stamps the object with that id so it can be identified in the future.

Stamping an object involves adding a _yuid property to it that contains the object's id. One exception to this is that in Internet Explorer, DOM nodes have a uniqueID property that contains a browser-generated unique id, which will be used instead of a YUI-generated id when available.

Parameters:

  • o Object

    Object to stamp.

  • readOnly Boolean

    If truthy and the given object has not already been stamped, the object will not be modified and null will be returned.

Returns:

String:

Object's unique id, or null if readOnly was truthy and the given object was not already stamped.

subscribe

() deprecated

Inherited from EventTarget: event-custom/js/event-target.js:346

Deprecated: use on

subscribe to an event

throttle

(
  • fn
  • ms
)
Function

Provided by the yui-throttle module.

Defined in yui-throttle/js/throttle.js:20

Available since 3.1.0

Throttles a call to a method based on the time between calls.

Parameters:

  • fn Function

    The function call to throttle.

  • ms Number

    The number of milliseconds to throttle the method call. Can set globally with Y.config.throttleTime or by call. Passing a -1 will disable the throttle. Defaults to 150.

Returns:

Function:

Returns a wrapped function that calls fn throttled.

unsubscribe

() deprecated

Inherited from EventTarget: event-custom/js/event-target.js:469

Deprecated: use detach

detach a listener

unsubscribeAll

(
  • type
)
deprecated

Inherited from EventTarget: event-custom/js/event-target.js:490

Deprecated: use detachAll

Removes all listeners from the specified event. If the event type is not specified, all listeners from all hosted custom events will be removed.

Parameters:

  • type String

    The type, or name of the event

use

(
  • modules
  • [callback]
)
chainable

Defined in yui/js/yui.js:923

Attaches one or more modules to this YUI instance. When this is executed, the requirements of the desired modules are analyzed, and one of several things can happen:

  • All required modules have already been loaded, and just need to be attached to this YUI instance. In this case, the use() callback will be executed synchronously after the modules are attached.

  • One or more modules have not yet been loaded, or the Get utility is not available, or the bootstrap config option is false. In this case, a warning is issued indicating that modules are missing, but all available modules will still be attached and the use() callback will be executed synchronously.

  • One or more modules are missing and the Loader is not available but the Get utility is, and bootstrap is not false. In this case, the Get utility will be used to load the Loader, and we will then proceed to the following state:

  • One or more modules are missing and the Loader is available. In this case, the Loader will be used to resolve the dependency tree for the missing modules and load them and their dependencies. When the Loader is finished loading modules, the use() callback will be executed asynchronously.

Parameters:

  • modules String | Array multiple

    One or more module names to attach.

  • [callback] Function optional

    Callback function to be executed once all specified modules and their dependencies have been attached.

    • Y YUI

      The YUI instance created for this sandbox.

    • status Object

      Object containing success, msg and data properties.

Example:

// Loads and attaches dd and its dependencies.
            YUI().use('dd', function (Y) {
                // ...
            });
            
            // Loads and attaches dd and node as well as all of their dependencies.
            YUI().use(['dd', 'node'], function (Y) {
                // ...
            });
            
            // Attaches all modules that have already been loaded.
            YUI().use('*', function (Y) {
                // ...
            });
            
            // Attaches a gallery module.
            YUI().use('gallery-yql', function (Y) {
                // ...
            });
            
            // Attaches a YUI 2in3 module.
            YUI().use('yui2-datatable', function (Y) {
                // ...
            });

when

(
  • promise
  • [callback]
  • [errback]
)
Promise

Provided by the promise module.

Defined in promise/js/when.js:1

Abstraction API allowing you to interact with promises or raw values as if they were promises. If a non-promise object is passed in, a new Resolver is created and scheduled to resolve asynchronously with the provided value.

In either case, a promise is returned. If either callback or errback are provided, the promise returned is the one returned from calling promise.then(callback, errback) on the provided or created promise. If neither are provided, the original promise is returned.

Parameters:

  • promise Any

    Promise object or value to wrap in a resolved promise

  • [callback] Function optional

    callback to execute if the promise is resolved

  • [errback] Function optional

    callback to execute if the promise is rejected

Returns:

Properties

Global

EventTarget

Provided by the event-custom-base module.

Defined in event-custom/js/event-target.js:878

Hosts YUI page level events. This is where events bubble to when the broadcast config is set to 2. This property is only available if the custom event module is loaded.

GlobalConfig

Object static

Defined in yui/js/yui.js:75

Master configuration that might span multiple contexts in a non- browser environment. It is applied first to all instances in all contexts.

Example:

YUI.GlobalConfig = {
                filter: 'debug'
            };
            
            YUI().use('node', function (Y) {
                // debug files used here
            });
            
            YUI({
                filter: 'min'
            }).use('node', function (Y) {
                // min files used here
            });

meta

Unknown

Provided by the loader-base module.

Defined in loader/js/loader.js:52

The component metadata is stored in Y.Env.meta. Part of the loader module.

version

String

Defined in yui/js/yui.js:336

The version number of this YUI instance.

This value is typically updated by a script when a YUI release is built, so it may not reflect the correct version number when YUI is run from the development source tree.

YUI_config

Object

Defined in yui/js/yui.js:104

Page-level config applied to all YUI instances created on the current page. This is applied after YUI.GlobalConfig and before any instance-level configuration.

Example:

// Single global var to include before YUI seed file
            YUI_config = {
                filter: 'debug'
            };
            
            YUI().use('node', function (Y) {
                // debug files used here
            });
            
            YUI({
                filter: 'min'
            }).use('node', function (Y) {
                // min files used here
            });

Events

available

Provided by the event-base module.

Defined in event/js/available.js:8

Executes the callback as soon as the specified element is detected in the DOM. This function expects a selector string for the element(s) to detect. If you already have an element reference, you don't need this event.

Event Payload:

  • type String

    'available'

  • fn Function

    the callback function to execute.

  • el String

    an selector for the element(s) to attach

  • context Object

    optional argument that specifies what 'this' refers to.

  • args Object Multiple

    0..n additional arguments to pass on to the callback function. These arguments will be added after the event object.

contentready

Provided by the event-base module.

Defined in event/js/available.js:30

Executes the callback as soon as the specified element is detected in the DOM with a nextSibling property (indicating that the element's children are available). This function expects a selector string for the element(s) to detect. If you already have an element reference, you don't need this event.

Event Payload:

  • type String

    'contentready'

  • fn Function

    the callback function to execute.

  • el String

    an selector for the element(s) to attach.

  • context Object

    optional argument that specifies what 'this' refers to.

  • args Object Multiple

    0..n additional arguments to pass on to the callback function. These arguments will be added after the event object.

domready

Provided by the event module.

Defined in event/js/event-ready.js:7

The domready event fires at the moment the browser's DOM is usable. In most cases, this is before images are fully downloaded, allowing you to provide a more responsive user interface.

In YUI 3, domready subscribers will be notified immediately if that moment has already passed when the subscription is created.

One exception is if the yui.js file is dynamically injected into the page. If this is done, you must tell the YUI instance that you did this in order for DOMReady (and window load events) to fire normally. That configuration option is 'injected' -- set it to true if the yui.js script is not included inline.

This method is part of the 'event-ready' module, which is a submodule of 'event'.

flick

Provided by the event-flick module.

Defined in event-gestures/js/Flick.js:54

Sets up a "flick" event, that is fired whenever the user initiates a flick gesture on the node where the listener is attached. The subscriber can specify a minimum distance or velocity for which the event is to be fired. The subscriber can also specify if there is a particular axis which they are interested in - "x" or "y". If no axis is specified, the axis along which there was most distance covered is used.

It is recommended that you use Y.bind to set up context and additional arguments for your event handler, however if you want to pass the context and arguments as additional signature arguments to "on", you need to provide a null value for the configuration object, e.g: node.on("flick", fn, null, context, arg1, arg2, arg3)

Event Payload:

  • type String

    "flick"

  • fn Function

    The method the event invokes. It receives an event facade with an e.flick object containing the flick related properties: e.flick.time, e.flick.distance, e.flick.velocity and e.flick.axis, e.flick.start.

  • cfg Object

    Optional. An object which specifies any of the following:

    minDistance (in pixels, defaults to 10)
    The minimum distance between start and end points, which would qualify the gesture as a flick.
    minVelocity (in pixels/ms, defaults to 0)
    The minimum velocity which would qualify the gesture as a flick.
    preventDefault (defaults to false)
    Can be set to true/false to prevent default behavior as soon as the touchstart/touchend or mousedown/mouseup is received so that things like scrolling or text selection can be prevented. This property can also be set to a function, which returns true or false, based on the event facade passed to it.
    axis (no default)
    Can be set to "x" or "y" if you want to constrain the flick velocity and distance to a single axis. If not defined, the axis along which the maximum distance was covered is used.

gesturemove

Provided by the event-move module.

Defined in event-gestures/js/Move.js:368

Sets up a "gesturemove" event, that is fired on touch devices in response to a single finger "touchmove", and on mouse based devices in response to a "mousemove".

By default this event is only fired when the same node has received a "gesturemovestart" event. The subscriber can set standAlone to true, in the configuration properties, if they want to listen for this event without an initial "gesturemovestart".

By default this event sets up it's internal "touchmove" and "mousemove" DOM listeners on the document element. The subscriber can set the root configuration property, to specify which node to attach DOM listeners to, if different from the document.

This event can also be listened for using node.delegate().

It is recommended that you use Y.bind to set up context and additional arguments for your event handler, however if you want to pass the context and arguments as additional signature arguments to on/delegate, you need to provide a null value for the configuration object, e.g: node.on("gesturemove", fn, null, context, arg1, arg2, arg3)

Event Payload:

  • type String

    "gesturemove"

  • fn Function

    The method the event invokes. It receives the event facade of the underlying DOM event (mousemove or touchmove.touches[0]) which contains position co-ordinates.

  • cfg Object

    Optional. An object which specifies:

    standAlone (defaults to false)
    true, if the subscriber should be notified even if a "gesturemovestart" has not occured on the same node.
    root (defaults to document)
    The node to which the internal DOM listeners should be attached.
    preventDefault (defaults to false)
    Can be set to true/false to prevent default behavior as soon as the touchmove or mousemove is received. As with gesturemovestart, can also be set to function which returns true/false based on the event facade passed to it.

gesturemoveend

Provided by the event-move module.

Defined in event-gestures/js/Move.js:504

Sets up a "gesturemoveend" event, that is fired on touch devices in response to a single finger "touchend", and on mouse based devices in response to a "mouseup".

By default this event is only fired when the same node has received a "gesturemove" or "gesturemovestart" event. The subscriber can set standAlone to true, in the configuration properties, if they want to listen for this event without a preceding "gesturemovestart" or "gesturemove".

By default this event sets up it's internal "touchend" and "mouseup" DOM listeners on the document element. The subscriber can set the root configuration property, to specify which node to attach DOM listeners to, if different from the document.

This event can also be listened for using node.delegate().

It is recommended that you use Y.bind to set up context and additional arguments for your event handler, however if you want to pass the context and arguments as additional signature arguments to on/delegate, you need to provide a null value for the configuration object, e.g: node.on("gesturemoveend", fn, null, context, arg1, arg2, arg3)

Event Payload:

  • type String

    "gesturemoveend"

  • fn Function

    The method the event invokes. It receives the event facade of the underlying DOM event (mouseup or touchend.changedTouches[0]).

  • cfg Object

    Optional. An object which specifies:

    standAlone (defaults to false)
    true, if the subscriber should be notified even if a "gesturemovestart" or "gesturemove" has not occured on the same node.
    root (defaults to document)
    The node to which the internal DOM listeners should be attached.
    preventDefault (defaults to false)
    Can be set to true/false to prevent default behavior as soon as the touchend or mouseup is received. As with gesturemovestart, can also be set to function which returns true/false based on the event facade passed to it.

gesturemovestart

Provided by the event-move module.

Defined in event-gestures/js/Move.js:168

Sets up a "gesturemovestart" event, that is fired on touch devices in response to a single finger "touchstart", and on mouse based devices in response to a "mousedown". The subscriber can specify the minimum time and distance thresholds which should be crossed before the "gesturemovestart" is fired and for the mouse, which button should initiate a "gesturemovestart". This event can also be listened for using node.delegate().

It is recommended that you use Y.bind to set up context and additional arguments for your event handler, however if you want to pass the context and arguments as additional signature arguments to on/delegate, you need to provide a null value for the configuration object, e.g: node.on("gesturemovestart", fn, null, context, arg1, arg2, arg3)

Event Payload:

  • type String

    "gesturemovestart"

  • fn Function

    The method the event invokes. It receives the event facade of the underlying DOM event (mousedown or touchstart.touches[0]) which contains position co-ordinates.

  • cfg Object

    Optional. An object which specifies:

    minDistance (defaults to 0)
    The minimum distance threshold which should be crossed before the gesturemovestart is fired
    minTime (defaults to 0)
    The minimum time threshold for which the finger/mouse should be help down before the gesturemovestart is fired
    button (no default)
    In the case of a mouse input device, if the event should only be fired for a specific mouse button.
    preventDefault (defaults to false)
    Can be set to true/false to prevent default behavior as soon as the touchstart or mousedown is received (that is before minTime or minDistance thresholds are crossed, and so before the gesturemovestart listener is notified) so that things like text selection and context popups (on touch devices) can be prevented. This property can also be set to a function, which returns true or false, based on the event facade passed to it (for example, DragDrop can determine if the target is a valid handle or not before preventing default).

hashchange

Provided by the history-hash module.

Defined in history/js/history-hash.js:338

Available since 3.2.0

Synthetic window.onhashchange event that normalizes differences across browsers and provides support for browsers that don't natively support onhashchange.

This event is provided by the history-hash module.

Event Payload:

  • e EventFacade

    Event facade with the following additional properties:

    oldHash
    Previous hash fragment value before the change.
    oldUrl
    Previous URL (including the hash fragment) before the change.
    newHash
    New hash fragment value after the change.
    newUrl
    New URL (including the hash fragment) after the change.

Example:

YUI().use('history-hash', function (Y) {
              Y.on('hashchange', function (e) {
                // Handle hashchange events on the current window.
              }, Y.config.win);
            });

key

Provided by the event-key module.

Defined in event/js/key.js:132

Add a key listener. The listener will only be notified if the keystroke detected meets the supplied specification. The specification is a string that is defined as:

spec
[{type}:]{code}[,{code}]
type
"down", "up", or "press"
code
{keyCode|character|keyName}[+{modifier}]
modifier
"shift", "ctrl", "alt", or "meta"
keyName
"enter", "space", "backspace", "esc", "tab", "pageup", or "pagedown"

Examples:

  • Y.on("key", callback, "press:12,65+shift+ctrl", "#my-input");
  • Y.delegate("key", preventSubmit, "#forms", "enter", "input[type=text]");
  • Y.one("doc").on("key", viNav, "j,k,l,;");

Event Payload:

  • type String

    'key'

  • fn Function

    the function to execute

  • id String | HTMLElement | Collection

    the element(s) to bind

  • spec String

    the keyCode and modifier specification

  • o Object

    optional context object

  • args Object

    0..n additional arguments to provide to the listener.

mousewheel

Provided by the event-mousewheel module.

Defined in event/js/mousewheel.js:25

Mousewheel event. This listener is automatically attached to the correct target, so one should not be supplied. Mouse wheel direction and velocity is stored in the 'wheelDelta' field.

Event Payload:

  • type String

    'mousewheel'

  • fn Function

    the callback to execute

  • context Object

    optional context object

  • args Object

    0..n additional arguments to provide to the listener.

valuechange

Synthetic event that fires when the value property of an <input>, <textarea>, <select>, or [contenteditable="true"] node changes as a result of a user-initiated keystroke, mouse operation, or input method editor (IME) input event.

Unlike the onchange event, this event fires when the value actually changes and not when the element loses focus. This event also reports IME and multi-stroke input more reliably than oninput or the various key events across browsers.

For performance reasons, only focused nodes are monitored for changes, so programmatic value changes on nodes that don't have focus won't be detected.

Event Payload:

  • prevVal String

    Previous value prior to the latest change.

  • newVal String

    New value after the latest change.

Example:

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);
                });
            });

windowresize

Provided by the event-resize module.

Defined in event/js/resize-window.js:9

Old firefox fires the window resize event once when the resize action finishes, other browsers fire the event periodically during the resize. This code uses timeout logic to simulate the Firefox behavior in other browsers.