本文介绍的是underscore.js提供的Utility Functions。
noConflict_.noConflict()
Give control of the "_" variable back to its previous owner. Returns a reference to theUnderscore object.
这个函数主要是为了解决underscore.js与其他框架或js名字冲突的问题。我们知道:underscore.js使用全局对象_,如果在underscore框架加载前,已经有了这么一个全局变量会怎么样呢?
<html> <head> <script> // 在underscore.js框架加载前运行,目的是验证_.noConflict(); var _ = "11"; </script> <script src="underscore-1.7.0/underscore.js"></script> <script> //underscore是返回的underscore.js封装对象 var underscore = _.noConflict(); alert(underscore.VERSION); // _之前是什么,现在就还原成什么. alert(_);//11 </script> </head> <body> </body> </html>首先定义了一个全局变量_,当underscore框架加载后,_之前的值被覆盖。当调用_.noConflict()之后,该函数返回是underscore封装的对象,仍然可以使用这个函数的返回值调用underscore.js提供的API。_被还原成underscore.js加载之前的值,就是11。
identity_.identity(value)
Returns the same value that is used as the argument. In math: f(x) = x
This function looks useless, but is used throughout Underscore as a default iteratee.
var moe = {name: ‘moe‘};
moe === _.identity(moe);
=> true
该函数啥也不做,就是直接返回传递给他的参数值,即数学中的f(x) = x。
constant_.constant(value)
Creates a function that returns the same value that is used as the argument of_.constant.
var moe = {name: ‘moe‘}; moe === _.constant(moe)(); => true该constant()返回值是一个函数(这个函数返回的就是传递给constant()函数的参数)。
noop_.noop()
Returns undefined irrespective(不管) of the arguments passed to it. Useful
as the default for optional callback arguments.
obj.initialize = _.noop;
noop就是no operation的缩写,就是一个空函数,啥也不干,返回值是undefined或者说是没有返回值。有点像null object模式,避免使用者判空。
times_.times(n,
iteratee, [context])
Invokes the given iteratee function n times.
Each invocation of iteratee is
called with an index argument.
Produces an array of the returned values.
var result = _.times(3, function(i){return i * 10;}) console.log("times=" + result);// 0,10,20 result = _(3).times(function(i){ return i * 10; }); console.log("times=" + result);// 0,10,20上面这2种写法是等价的
random_.random(min,
max)
Returns a random integer between min and max, inclusive. If you only pass one argument, it will return a number between 0 and
that number.
_.random(0, 100);
=> 42
mixin_.mixin(object)
Allows you to extend Underscore with your own utility functions. Pass a hash of {name:
function} definitions to have your functions added to the Underscore object, as well as the OOP wrapper.
_.mixin({
capitalize: function(string) {
return string.charAt(0).toUpperCase() + string.substring(1).toLowerCase();
}
});
_("fabio").capitalize();
=> "Fabio"
uniqueId_.uniqueId([prefix])
Generate a globally-unique id for client-side models or DOM elements that need one. Ifprefix is passed, the id will be appended to it.
_.uniqueId(‘contact_‘); => ‘contact_104‘返回id,在当前html是唯一的;或者说:同一个_对象内是唯一的
escape_.escape(string)
Escapes a string for insertion into HTML, replacing &, <, >, ", `,
and ‘characters.
_.escape(‘Curly, Larry & Moe‘);
=> "Curly, Larry & Moe"
unescape_.unescape(string)
The opposite of escape, replaces &, <, >, ", ` and 'with
their unescaped counterparts.
_.unescape(‘Curly, Larry & Moe‘); => "Curly, Larry & Moe"
result_.result(object,
property)
If the value of the named property is a function then invoke it with the object as context; otherwise, return it.
var object = {cheese: ‘crumpets‘, stuff: function(){ return ‘nonsense‘; }}; _.result(object, ‘cheese‘); => "crumpets" _.result(object, ‘stuff‘); => "nonsense"
now_.now()
Returns an integer timestamp for the current time, using the fastest method available in the runtime. Useful for implementing timing/animation functions.
_.now(); => 1392066795351
template_.template(templateString,
[settings])
Compiles JavaScript templates into functions that can be evaluated for rendering. Useful for rendering complicated bits of HTML from
JSON data sources. Template functions can both interpolate variables, using <%= … %>,
as well as execute arbitrary JavaScript code, with <% … %>.
If you wish to interpolate a value, and have it be HTML-escaped, use <%- … %> When
you evaluate a template function, pass in a data object
that has properties corresponding to the template‘s free variables. The settingsargument
should be a hash containing any _.templateSettings that
should be overridden.
1、模板很类似JS模板引擎,如artTemplate、Handlebars、Mustache等JS模板框架,主要是为了避免在javascript中拼接DOM字符串(非常的繁琐,而且很容易出错)。underscore.js提供的模板有三种使用方式:即<%= %>和<%- %>和<% %>。
// 替换普通变量 var varcompiled = _.template("<h2><%= word %></h2>"); console.log("template=" + varcompiled({word : "Hello World"})); // 变量的值包含五个特殊字符(& < > " ' /),就需要用<%- ... %>转义 var escape = _.template("<h2><%- word %></h2>"); console.log("template=" + escape({word : "Hello & World"})); //JavaScript命令可以采用<% … %>的形式插入 var compiled = _.template("<% console.log('Hello ' + epithet); %>"); compiled({epithet: "hehe"});
2、改变变量默认名称
//改变内部变量名称 //templateString中的所有变量,在内部都是obj对象的属性,而obj对象就是指第二个参数data对象。 // 下面语句是等同的。 console.log(_.template("Hello <%=user%>!")({ user: "jane" })); console.log(_.template("Hello <%=obj.user%>!")({ user: "jane" })); console.log(_.template("Hello <%=data.user%>!",{variable: 'data'})({ user: "jane" }));
// 查看预编译的源码 console.log(_.template("Hello <%=user%>!").source);
4、模板格式的设置
之前提到过,underscore提供3种格式的模板<%= %>和<%- %>和<% %>。对应的源码如下:
// By default, Underscore uses ERB-style template delimiters, change the // following template settings to use alternative delimiters. _.templateSettings = { evaluate : /<%([\s\S]+?)%>/g, interpolate : /<%=([\s\S]+?)%>/g, escape : /<%-([\s\S]+?)%>/g };
我们知道<%= %>这种格式与JSP中嵌入java代码使用的方式一致,如果在JSP中写java代码和underscore模板,那么会冲突。我们通过设置,可以改变underscore模板的格式。下面的代码,用{}这种格式替换<%= %>
var newformat = _.template("Hello {user}!",{interpolate : /{([\s\S]+?)}/g}); console.log("result=" + newformat({ user: "jane" }));
5、还有一点值得注意,就是underscore提供的三种格式是可以一起使用的,这样的话,模板里面就可以写if、while等逻辑控制了。比如有这么一个对象,{"flag":true,"name":"aty","age":20},我们的模板需要根据flag的值进行判断,如果是true,则返回name的值,如果是false则返回age的值。
//很类似于jsp中写java var tpt = "<% if (flag){ %>" + "<%= name %>" + "<% } %>"; + "<% else {%>" + "<%= age %>" + "<% } %>"; var resultFunc = _.template(tpt); console.log("result=" + resultFunc({"flag":true,"name":"aty","age":20}));可以看到:这种使用方式,很类型与JSP中写java代码,如果逻辑比较复杂,括号的嵌套层次比较多,那么这种方式写出的代码几乎不可读。上面的代码功能其实就是
if(flag) { return name; } else { return age; }
可以看到直接写javascript代码简单的多。这也是underscore模板的不足之处,虽然支持写javascript代码,但是非常复杂。等有时间我再去学习了专门的JS模板引擎,看它们是否能够实现的更优雅。
最后,underscore_1.7.0版本中utility还提供了一个iteratee函数,这个函数也比较复杂,而且主要是框架内部使用。后续再专门研究这个函数,单独写一篇博文。