var s = String.leftPad('123', 5, '0');
// s现在包含了这样的字符串: '00123'
*
// 交替排序方向
sort = sort.toggle('ASC', 'DESC');
// 相当于这样的表达式:
sort = (sort == 'ASC' ? 'DESC' : 'ASC');
var s = ' foo bar ';
alert('-' + s + '-'); //提示 "- foo bar -"
alert('-' + s.trim() + '-'); //提示 "-foo bar-"
var cls = 'my-class', text = 'Some text', src = '<div class="{0}">{1}</div>';
var s = src.format(cls, text);
// s现在包含的字符串为: '<div class="my-class">Some text</div>'
var hello1 = "hello {key:world}", hello2 = "hello {0:world}";
var r = hello1.format(); // r现在包含的字符串为: 'hello world'
r = hello1.format({key:"Mary"}); // r现在包含的字符串为: 'hello Mary'
r = hello2.format("Mary"); // r现在包含的字符串为: 'hello Mary'
// 使用前缀拼接命令
var cmd = "flow-rule {id} session-limit {session:8000} action {action:pass} {in-channel=>in} {out-channel=>out}";
var t = cmd.format({id:1, "in":"inside", "out":"outside"});
// t现在包含的字符串为: 'flow-rule 1 session-limit 8000 action pass in-channel inside out-channel outside'
*
var sayHi = function(name){
alert('Hi, ' + name);
}
sayHi('Fred'); // 提示"Hi, Fred"
var sayGoodbye = sayHi.createSequence(function(name){
alert('Bye, ' + name);
});
sayGoodbye('Fred'); // 弹出两次提示
this所指的对象)。
* 如果没有指定，默认为原始函数执行的域对象或者浏览器的window对象。
* @return {Function} 新函数
*/
createSequence : function(fcn, scope){
var method = this;
return (typeof fcn != 'function') ?
this :
function(){
var retval = method.apply(this || window, arguments);
fcn.apply(scope || this || window, arguments);
return retval;
};
},
/**
* 创建一个函数的回调同时传入参数arguments[0], arguments[1], arguments[2], ...可在任何函数上直接调用。例如: myFunction.createCallback(arg1, arg2)
* 将创建一个函数执行时传入这两个参数。如果需要在函数执行时指定域对象可使用{@link #createDelegate}代替。这个函数返回的回调将永远在window的域下执行。
* 这个函数在你需要指定参数进行回调时候被使用。如果没有需要传入的参数，你能够直接使用函数的引用(e.g., callback: myFn)。 * 但是如果当你需要传入参数(e.g., callback: myFn(arg1, arg2))，这个函数将会在脚本解析到这里立刻执行。例程: *
var sayHi = function(name){
alert('Hi, ' + name);
}
// 点击按钮提示"Hi, Fred"
new Button({
text: 'Say Hi',
handler: sayHi.createCallback('Fred')
});
var sayHi = function(name){
alert('Hi, ' + name);
}
sayHi('Fred'); // 提示"Hi, Fred"
// 创建一个验证输入的新函数不需直接修改原始函数:
var sayHiToFriend = sayHi.createInterceptor(function(name){
return name == 'Brian';
});
sayHiToFriend('Fred'); // 没提示
sayHiToFriend('Brian'); // 提示"Hi, Brian"
this所指的对象)。
* 如果没有指定，默认为原始函数执行的域对象或者浏览器的window对象。
* @return {Function} 新函数
*/
createInterceptor : function(fcn, scope){
var method = this;
return !Util.isFunction(fcn) ?
this :
function() {
var me = this,
args = arguments;
fcn.target = me;
fcn.method = method;
return (fcn.apply(scope || me || window, args) !== false) ?
method.apply(me || window, args) :
null;
};
},
/**
* 创建一个设置函数域的函数代理。
* 对任何函数都能直接调用，例如: this.myFunction.createDelegate(this, [arg1, arg2])
* 将创建一个自动将this指针设置为某个对象的回调函数。例程:
*
var sayHi = function(name){
// 注意这里使用了"this.text"。这个函数需要在具有text属性的域对象中执行。在这个例子中"this"指向了下面传入的对象。
alert('Hi, ' + name + '. You clicked the "' + this.text + '" button.');
}
var btn = new Button({
text: 'Say Hi'
});
// 这个回调函数将在btn的域下执行。点击该按钮将打印:
// "Hi, Fred. You clicked the "Say Hi" button."
btn.on('click', sayHi.createDelegate(btn, ['Fred']));
this指向的对象)。
* 如果省略，将为浏览器的window对象。
* @param {Array} args (optional) 重写调用参数。(默认为函数被调用时传入的参数)
* @param {Boolean/Number} appendArgs (optional) 如果为True参数被添加入调用时传入的参数列表,
* 如果为数值则表示指定的参数插入位置。
* @return {Function} 新的函数。
*/
createDelegate : function(obj, args, appendArgs){
var method = this;
return function() {
var callArgs = args || arguments;
if (appendArgs === true){
callArgs = Array.prototype.slice.call(arguments, 0);
callArgs = callArgs.concat(args);
}else if (Util.isNumber(appendArgs)){
callArgs = Array.prototype.slice.call(arguments, 0);
var applyArgs = [appendArgs, 0].concat(args);
Array.prototype.splice.apply(callArgs, applyArgs);
}
return method.apply(obj || window, callArgs);
};
},
/**
* 在设定的毫秒数以后执行方法，在可选的函数域中。例程:
*
var sayHi = function(name){
alert('Hi, ' + name);
}
// 立刻执行:
sayHi('Fred');
// 两秒后执行:
sayHi.defer(2000, this, ['Fred']);
// 这种延时执行匿名函数的语法有时候很有用:
(function(){
alert('Anonymous');
}).defer(100);
this所指代的对象)。
* 如果省略，将为浏览器的window对象。
* @param {Array} args (optional) 重写调用参数。(默认为函数被调用时传入的参数)
* @param {Boolean/Number} appendArgs (optional) 如果为True参数被添加入调用时传入的参数列表,
* 如果为数值则表示指定的参数插入位置。
* @return {Number} 用于清除计时器的计时器ID
*/
defer : function(millis, obj, args, appendArgs){
var fn = this.createDelegate(obj, args, appendArgs);
if(millis > 0){
return setTimeout(fn, millis);
}
fn();
return 0;
}
});