Files
Ext-more.js
Ext.js

These functions are available on every Function object (any JavaScript function).

Defined By

Methods

Function
view source

createCallback( ) : Function

Creates a callback that passes arguments[0], arguments[1], arguments[2], ... ...

Creates a callback that passes arguments[0], arguments[1], arguments[2], ...\nCall directly on any function. Example: myFunction.createCallback(arg1, arg2)\nWill create a function that is bound to those 2 args. If a specific scope is required in the\ncallback, use createDelegate instead. The function returned by createCallback always\nexecutes in the window scope.

\n\n

This method is required when you want to pass arguments to a callback function. If no arguments\nare needed, you can simply pass a reference to the function as a callback (e.g., callback: myFn).\nHowever, if you tried to pass a function with arguments (e.g., callback: myFn(arg1, arg2)) the function\nwould simply execute immediately when the code is parsed. Example usage:\n

var sayHi = function(name){\n    alert('Hi, ' + name);\n}\n\n// clicking the button alerts \"Hi, Fred\"\nnew Ext.Button({\n    text: 'Say Hi',\n    renderTo: Ext.getBody(),\n    handler: sayHi.createCallback('Fred')\n});\n

\n\n

Returns

Function
The new function
\n

Function
view source

createDelegate( [scope], [args], [appendArgs] ) : Function

Creates a delegate (callback) that sets the scope to obj. ...

Creates a delegate (callback) that sets the scope to obj.\nCall directly on any function. Example: this.myFunction.createDelegate(this, [arg1, arg2])\nWill create a function that is automatically scoped to obj so that the this variable inside the\ncallback points to obj. Example usage:

\n\n

var sayHi = function(name){\n    // Note this use of \"this.text\" here.  This function expects to\n    // execute within a scope that contains a text property.  In this\n    // example, the \"this\" variable is pointing to the btn object that\n    // was passed in createDelegate below.\n    alert('Hi, ' + name + '. You clicked the \"' + this.text + '\" button.');\n}\n\nvar btn = new Ext.Button({\n    text: 'Say Hi',\n    renderTo: Ext.getBody()\n});\n\n// This callback will execute in the scope of the\n// button instance. Clicking the button alerts\n// \"Hi, Fred. You clicked the \"Say Hi\" button.\"\nbtn.on('click', sayHi.createDelegate(btn, ['Fred']));\n

\n\n

Parameters

scope : Object (optional)
The scope (this reference) in which the function is executed.\nIf omitted, defaults to the browser window.
\n
args : Array (optional)
Overrides arguments for the call. (Defaults to the arguments passed by the caller)
\n
appendArgs : Boolean/Number (optional)
if True args are appended to call args instead of overriding,\nif a number the args are inserted at the specified position
\n

Returns

Function
The new function
\n

Function
view source

createInterceptor( fcn, [scope] ) : Function

Creates an interceptor function. ...

Creates an interceptor function. The passed function is called before the original one. If it returns false,\nthe original one is not called. The resulting function returns the results of the original function.\nThe passed function is called with the parameters of the original function. Example usage:

\n\n

var sayHi = function(name){\n    alert('Hi, ' + name);\n}\n\nsayHi('Fred'); // alerts \"Hi, Fred\"\n\n// create a new function that validates input without\n// directly modifying the original function:\nvar sayHiToFriend = sayHi.createInterceptor(function(name){\n    return name == 'Brian';\n});\n\nsayHiToFriend('Fred');  // no alert\nsayHiToFriend('Brian'); // alerts \"Hi, Brian\"\n

\n\n

Parameters

fcn : Function
The function to call before the original
\n
scope : Object (optional)
The scope (this reference) in which the passed function is executed.\nIf omitted, defaults to the scope in which the original function is called or the browser window.
\n

Returns

Function
The new function
\n

Function
view source

createSequence( fcn, [scope] ) : Function

Create a combined function call sequence of the original function + the passed function. ...

Create a combined function call sequence of the original function + the passed function.\nThe resulting function returns the results of the original function.\nThe passed fcn is called with the parameters of the original function. Example usage:

\n\n

var sayHi = function(name){\n    alert('Hi, ' + name);\n}\n\nsayHi('Fred'); // alerts \"Hi, Fred\"\n\nvar sayGoodbye = sayHi.createSequence(function(name){\n    alert('Bye, ' + name);\n});\n\nsayGoodbye('Fred'); // both alerts show\n

\n\n

Parameters

fcn : Function
The function to sequence
\n
scope : Object (optional)
The scope (this reference) in which the passed function is executed.\nIf omitted, defaults to the scope in which the original function is called or the browser window.
\n

Returns

Function
The new function
\n

Function
view source

defer( millis, [scope], [args], [appendArgs] ) : Number

Calls this function after the number of millseconds specified, optionally in a specific scope. ...

Calls this function after the number of millseconds specified, optionally in a specific scope. Example usage:

\n\n

var sayHi = function(name){\n    alert('Hi, ' + name);\n}\n\n// executes immediately:\nsayHi('Fred');\n\n// executes after 2 seconds:\nsayHi.defer(2000, this, ['Fred']);\n\n// this syntax is sometimes useful for deferring\n// execution of an anonymous function:\n(function(){\n    alert('Anonymous');\n}).defer(100);\n

\n\n

Parameters

millis : Number
The number of milliseconds for the setTimeout call (if less than or equal to 0 the function is executed immediately)
\n
scope : Object (optional)
The scope (this reference) in which the function is executed.\nIf omitted, defaults to the browser window.
\n
args : Array (optional)
Overrides arguments for the call. (Defaults to the arguments passed by the caller)
\n
appendArgs : Boolean/Number (optional)
if True args are appended to call args instead of overriding,\nif a number the args are inserted at the specified position
\n

Returns

Number
The timeout id that can be used with clearTimeout
\n