实用功能(Utility Functions)
noConflict_.noConflict()
放弃Underscore 的控制变量 _
。返回Underscore 对象的引用。
var underscore = _.noConflict();
identity_.identity(value)
返回与传入参数相等的值. 相当于数学里的: f(x) = x
这个函数看似无用, 但是在 Underscore 里被用作默认的迭代器 iterator.
var stooge = {name: 'moe'}; stooge === _.identity(stooge); => true
constant_.constant(value)
创建一个函数,这个函数 返回相同的值 用来作为 _.constant
的参数。
var stooge = {name: 'moe'}; stooge === _.constant(stooge)(); => true
noop_.noop()
返回 undefined
,不论传递给它的是什么参数。 可以用作默认可选的回调参数。
obj.initialize = _.noop;
times_.times(n, iteratee, [context])
调用给定的迭代函数n次,每一次调用iteratee传递 index
参数。生成一个返回值的数组。
_.times(3, function(n){ genie.grantWishNumber(n); });
random_.random(min, max)
返回一个min 和 max之间的随机整数。如果你只传递一个参数,那么将返回 0
和这个参数之间的整数。
_.random(0, 100); => 42
mixin_.mixin(object)
允许用您自己的实用程序函数扩展 Underscore。传递一个 {name: function}
定义的哈希添加到 Underscore 对象,以及面向对象封装。
_.mixin({ capitalize: function(string) { return string.charAt(0).toUpperCase() + string.substring(1).toLowerCase(); } }); _("fabio").capitalize(); => "Fabio"
iteratee_.iteratee(value, [context])
生成可应用于集合中的每个元素的回调。 _.iteratee
支持许多常见回调用例的简写语法。根据值的类型, _.iteratee
将返回:
// No value _.iteratee(); => _.identity() // Function _.iteratee(function(n) { return n * 2; }); => function(n) { return n * 2; } // Object _.iteratee({firstName: 'Chelsea'}); => _.matcher({firstName: 'Chelsea'}); // Anything else _.iteratee('firstName'); => _.property('firstName');
通过 _.iteratee
转换判断的 Underscore 方法的完整列表是: countBy
, every
, filter
, find
, findIndex
, findKey
, findLastIndex
, groupBy
, indexBy
, map
, mapObject
, max
, min
, partition
, reject
, some
, sortBy
, sortedIndex
, and uniq
如果您需要其他或不同的简写语法,可以使用自己的自定义函数覆盖 _.iteratee
:
// Support `RegExp` predicate shorthand. var builtinIteratee = _.iteratee; _.iteratee = function(value, context) { if (_.isRegExp(value)) return function(obj) { return value.test(obj) }; return builtinIteratee(value, context); };
uniqueId_.uniqueId([prefix])
为需要的客户端模型或 DOM 元素生成一个全局唯一的 id。如果prefix参数存在, id 将附加给它。
_.uniqueId('contact_'); => 'contact_104'
escape_.escape(string)
转义 HTML 字符串,替换 &
, <
, >
, "
, '
, 和 /
字符。
_.escape('Curly, Larry & Moe'); => "Curly, Larry & Moe"
unescape_.unescape(string)
和 escape 相反。转义 HTML 字符串,替换 &
, <
, >
, "
, `
, 和 /
字符。
_.unescape('Curly, Larry & Moe'); => "Curly, Larry & Moe"
result_.result(object, property, [defaultValue])
如果指定的property 的值是一个函数,那么将在object上下文内调用它;否则,返回它。如果提供默认值,并且属性不存在,那么默认值将被返回。如果设置 defaultValue
是一个函数,它的结果将被返回。
var object = {cheese: 'crumpets', stuff: function(){ return 'nonsense'; }}; _.result(object, 'cheese'); => "crumpets" _.result(object, 'stuff'); => "nonsense" _.result(object, 'meat', 'ham'); => "ham"
now_.now()
一个优化的方式来获得一个当前时间的整数时间戳。可用于实现定时/动画功能。
_.now(); => 1392066795351
template_.template(templateString, [settings])
将 JavaScript 模板编译为可以用于页面呈现的函数, 对于通过 JSON 数据源生成复杂的 HTML 并呈现出来的操作非常有用。 模板函数可以使用 <%= … %>
插入变量, 也可以用 <% … %>
执行任意的 JavaScript 代码。 如果您希望插入一个值, 并让其进行 HTML 转义,请使用 <%- … %>
。 当你要给模板函数赋值的时候,可以传递一个含有与模板对应属性的data对象 。 如果您要写一个一次性的, 您可以传对象 data 作为第二个参数给模板 template 来直接呈现, 这样页面会立即呈现而不是返回一个模板函数. 参数 settings 是一个哈希表包含任何可以覆盖的设置 _.templateSettings
.
var compiled = _.template("hello: <%= name %>"); compiled({name: 'moe'}); => "hello: moe" var template = _.template("<b><%- value %></b>"); template({value: '<script>'}); => "<b><script></b>"
您也可以在 JavaScript 代码中使用 print
. 有时候这会比使用 <%= ... %>
更方便.
var compiled = _.template("<% print('Hello ' + epithet); %>"); compiled({epithet: "stooge"}); => "Hello stooge"
如果 ERB 式的分隔符您不喜欢, 您可以改变 Underscore 的模板设置, 使用别的符号来嵌入代码.定义一个 interpolate 正则表达式来逐字匹配嵌入代码的语句, 如果想插入转义后的 HTML 代码则需要定义一个 escape 正则表达式来匹配,还有一个 evaluate 正则表达式来匹配您想要直接一次性执行程序而不需要任何返回值的语句.您可以定义或省略这三个的任意一个.例如, 要执行 Mustache.js 类型的模板:
_.templateSettings = { interpolate: /\{\{(.+?)\}\}/g }; var template = _.template("Hello {{ name }}!"); template({name: "Mustache"}); => "Hello Mustache!"
默认的, template 通过 with
语句来取得 data 所有的值. 当然, 您也可以在 variable 设置里指定一个变量名. 这样能显著提升模板的渲染速度.
_.template("Using 'with': <%= data.answer %>", {variable: 'data'})({answer: 'no'}); => "Using 'with': no"
预编译模板对调试不可重现的错误很有帮助. 这是因为预编译的模板可以提供错误的代码行号和堆栈跟踪, 有些模板在客户端(浏览器) 上是不能通过编译的 在编译好的模板函数上, 有 source 属性可以提供简单的预编译功能.
<script> JST.project = <%= _.template(jstText).source %>; </script>
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论