forked from lodash/lodash.com
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathindex.html
92 lines (80 loc) · 14 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
---
id: home
title: Lodash
description: A JavaScript utility library delivering consistency, modularity, performance, & extras.
layout: default
---
<section>
{% raw %}
<div class="highlight js intro"><pre><div><span class="source js"><span class="js"><span>_</span></span><span class="js"><span class="delimiter method js"><span>.</span></span><span class="js"><span>assign</span></span><span class="js"><span class="js"><span>(</span></span><span class="js"><span>{</span></span><span> </span><span class="string js"><span class="string js"><span>'</span></span><span>a</span><span class="string js"><span>'</span></span></span><span class="js"><span>:</span></span><span> </span><span class="constant numeric js"><span>1</span></span><span> </span><span class="js"><span>}</span></span><span class="delimiter js"><span>,</span></span><span> </span><span class="js"><span>{</span></span><span> </span><span class="string js"><span class="string js"><span>'</span></span><span>b</span><span class="string js"><span>'</span></span></span><span class="js"><span>:</span></span><span> </span><span class="constant numeric js"><span>2</span></span><span> </span><span class="js"><span>}</span></span><span class="delimiter js"><span>,</span></span><span> </span><span class="js"><span>{</span></span><span> </span><span class="string js"><span class="string js"><span>'</span></span><span>c</span><span class="string js"><span>'</span></span></span><span class="js"><span>:</span></span><span> </span><span class="constant numeric js"><span>3</span></span><span> </span><span class="js"><span>}</span></span><span class="js"><span>)</span></span></span></span><span class="js"><span>;</span></span></span></div><div><span class="source js"><span class="comment js"><span class="comment js"><span>//</span></span><span> → { 'a': 1, 'b': 2, 'c': 3 }</span><span> </span></span></span></div><div><span class="source js"><span class="js"><span>_</span></span><span class="js"><span class="delimiter method js"><span>.</span></span><span class="js"><span>map</span></span><span class="js"><span class="js"><span>(</span></span><span class="js"><span>[</span></span><span class="constant numeric js"><span>1</span></span><span class="delimiter js"><span>,</span></span><span> </span><span class="constant numeric js"><span>2</span></span><span class="delimiter js"><span>,</span></span><span> </span><span class="constant numeric js"><span>3</span></span><span class="js"><span>]</span></span><span class="delimiter js"><span>,</span></span><span> </span><span class="js"><span class="type js"><span>function</span></span><span class="js"><span class="js"><span>(</span></span><span class="js"><span>n</span></span><span class="js"><span>)</span></span></span></span><span> </span><span class="js"><span>{</span></span><span> </span><span class="js"><span>return</span></span><span> n </span><span class="js"><span>*</span></span><span> </span><span class="constant numeric js"><span>3</span></span><span class="js"><span>;</span></span><span> </span><span class="js"><span>}</span></span><span class="js"><span>)</span></span></span></span><span class="js"><span>;</span></span></span></div><div><span class="source js"><span class="comment js"><span class="comment js"><span>//</span></span><span> → [3, 6, 9]</span><span> </span></span></span></div></pre></div>
{% endraw %}
</section>
<section>
<p id="social"></p>
</section>
<section>
<h2>Download</h2>
<ul id="download-links">
<li>
<i class="fa fa-download" aria-hidden="true"></i><a href="https://raw.githubusercontent.com/lodash/lodash/{{ site.release }}/dist/lodash.core.js">Core build</a> (<a href="https://raw.githubusercontent.com/lodash/lodash/{{ site.release }}/dist/lodash.core.min.js">~4kB gzipped</a>)
</li>
<li>
<i class="fa fa-download" aria-hidden="true"></i><a href="https://raw.githubusercontent.com/lodash/lodash/{{ site.release }}/dist/lodash.js">Full build</a> (<a href="https://raw.githubusercontent.com/lodash/lodash/{{ site.release }}/dist/lodash.min.js">~21kB gzipped</a>)
</li>
<li>
<i class="fa fa-link" aria-hidden="true"></i><a href="https://www.jsdelivr.com/projects/lodash">CDN copies</a>
</li>
</ul>
<p>Lodash is released under the <a href="https://raw.githubusercontent.com/lodash/lodash/{{ site.release }}/LICENSE">MIT license</a> & supports <a href="#support">modern environments</a>.<br>Review the <a href="https://github.com/lodash/lodash/wiki/build-differences">build differences</a> & pick one that’s right for you.</p>
</section>
<section>
<h2>Installation</h2>
<p>In a browser:</p>
{% raw %}
<div class="highlight"><pre><div><span class="text html"><span class="html"><span class="html"><span><</span></span><span class="html"><span>script</span></span><span> </span><span class="html"><span>src</span></span><span>=</span><span class="string html"><span class="string html"><span>"</span></span><span>lodash.js</span><span class="string html"><span>"</span></span></span><span class="html"><span>></span><span class="html"><span><</span></span><span>/</span></span><span class="html"><span>script</span></span><span class="html"><span>></span></span></span></span></div></pre></div>
{% endraw %}
<p>Using npm:</p>
{% raw %}
<div class="highlight shell"><pre><div><span class="source shell"><span>$ npm i -g npm</span></span></div><div><span class="source shell"><span>$ npm i --save lodash</span></span></div></pre></div>
{% endraw %}
<p>In Node.js:</p>
{% raw %}
<div class="highlight js"><pre><div><span class="source js"><span class="comment js"><span class="comment js"><span>//</span></span><span> Load the full build.</span><span> </span></span></span></div><div><span class="source js"><span class="type js"><span>var</span></span><span> _ </span><span class="js"><span>=</span></span><span> </span><span class="js"><span class="js"><span>require</span></span><span class="js"><span class="js"><span>(</span></span><span class="string js"><span class="string js"><span>'</span></span><span>lodash</span><span class="string js"><span>'</span></span></span><span class="js"><span>)</span></span></span></span><span class="js"><span>;</span></span></span></div><div><span class="source js"><span class="comment js"><span class="comment js"><span>//</span></span><span> Load the core build.</span><span> </span></span></span></div><div><span class="source js"><span class="type js"><span>var</span></span><span> _ </span><span class="js"><span>=</span></span><span> </span><span class="js"><span class="js"><span>require</span></span><span class="js"><span class="js"><span>(</span></span><span class="string js"><span class="string js"><span>'</span></span><span>lodash/core</span><span class="string js"><span>'</span></span></span><span class="js"><span>)</span></span></span></span><span class="js"><span>;</span></span></span></div><div><span class="source js"><span class="comment js"><span class="comment js"><span>//</span></span><span> Load the fp build for immutable auto-curried iteratee-first data-last methods.</span><span> </span></span></span></div><div><span class="source js"><span class="type js"><span>var</span></span><span> fp </span><span class="js"><span>=</span></span><span> </span><span class="js"><span class="js"><span>require</span></span><span class="js"><span class="js"><span>(</span></span><span class="string js"><span class="string js"><span>'</span></span><span>lodash/fp</span><span class="string js"><span>'</span></span></span><span class="js"><span>)</span></span></span></span><span class="js"><span>;</span></span></span></div><div><span class="source js"><span> </span></span></div><div><span class="source js"><span class="comment js"><span class="comment js"><span>//</span></span><span> Load a method category.</span><span> </span></span></span></div><div><span class="source js"><span class="type js"><span>var</span></span><span> array </span><span class="js"><span>=</span></span><span> </span><span class="js"><span class="js"><span>require</span></span><span class="js"><span class="js"><span>(</span></span><span class="string js"><span class="string js"><span>'</span></span><span>lodash/array</span><span class="string js"><span>'</span></span></span><span class="js"><span>)</span></span></span></span><span class="js"><span>;</span></span></span></div><div><span class="source js"><span class="type js"><span>var</span></span><span> object </span><span class="js"><span>=</span></span><span> </span><span class="js"><span class="js"><span>require</span></span><span class="js"><span class="js"><span>(</span></span><span class="string js"><span class="string js"><span>'</span></span><span>lodash/fp/object</span><span class="string js"><span>'</span></span></span><span class="js"><span>)</span></span></span></span><span class="js"><span>;</span></span></span></div><div><span class="source js"><span> </span></span></div><div><span class="source js"><span class="comment js"><span class="comment js"><span>//</span></span><span> Load a single method for smaller builds with browserify/rollup/webpack.</span><span> </span></span></span></div><div><span class="source js"><span class="type js"><span>var</span></span><span> chunk </span><span class="js"><span>=</span></span><span> </span><span class="js"><span class="js"><span>require</span></span><span class="js"><span class="js"><span>(</span></span><span class="string js"><span class="string js"><span>'</span></span><span>lodash/chunk</span><span class="string js"><span>'</span></span></span><span class="js"><span>)</span></span></span></span><span class="js"><span>;</span></span></span></div><div><span class="source js"><span class="type js"><span>var</span></span><span> extend </span><span class="js"><span>=</span></span><span> </span><span class="js"><span class="js"><span>require</span></span><span class="js"><span class="js"><span>(</span></span><span class="string js"><span class="string js"><span>'</span></span><span>lodash/fp/extend</span><span class="string js"><span>'</span></span></span><span class="js"><span>)</span></span></span></span><span class="js"><span>;</span></span></span></div></pre></div>
{% endraw %}
<p><strong>Note:</strong><br>Don’t assign values to the <a href="https://nodejs.org/api/repl.html#repl_repl_features">special variable</a> <code>_</code> when in the Node.js < 6 REPL.<br>Install <a href="https://www.npmjs.com/package/n_">n_</a> for a REPL that includes <code>lodash</code> by default.</p>
</section>
<section>
<h2>Why Lodash?</h2>
<p>Lodash makes JavaScript easier by taking the hassle out of working with arrays, numbers, objects, strings, etc. Lodash’s modular methods are great for:</p>
<ul class="chevron">
<li>Iterating arrays, objects, & strings</li>
<li>Manipulating & testing values</li>
<li>Creating composite functions</li>
</ul>
</section>
<section>
<h2>Module Formats</h2>
<p>Lodash is available in a <a href="/custom-builds">variety of builds</a> & module formats.</p>
<ul class="chevron">
<li><a href="https://www.npmjs.com/package/lodash">lodash</a> & <a href="https://www.npmjs.com/browse/keyword/lodash-modularized">per method packages</a></li>
<li><a href="https://www.npmjs.com/package/lodash-es">lodash-es</a>, <a href="https://www.npmjs.com/package/babel-plugin-lodash">babel-plugin-lodash</a>, & <a href="https://www.npmjs.com/package/lodash-webpack-plugin">lodash-webpack-plugin</a></li>
<li><a href="https://github.com/lodash/lodash/tree/{{ site.release }}-npm/fp">lodash/fp</a></li>
<li><a href="https://www.npmjs.com/package/lodash-amd">lodash-amd</a></li>
</ul>
</section>
<section>
<h2>Further Reading</h2>
<ul class="chevron">
<li><a href="https://github.com/lodash/lodash/blob/{{ site.release }}/.github/CONTRIBUTING.md">Contributing</a></li>
<li><a href="https://github.com/lodash/lodash/releases/tag/4.0.0">Release Notes</a></li>
<li><a href="https://github.com/lodash/lodash/wiki">Wiki (Changelog, Roadmap, etc.)</a></li>
</ul>
</section>
<section>
<h2>Support</h2>
<p>Tested in Chrome 51-52, Firefox 47-48, IE 9-11, Edge 14, Safari 8-9, Node.js 4-6 & PhantomJS 2.1.1.</p>
<p>Automated <a href="https://saucelabs.com/u/lodash">browser</a> & <a href="https://travis-ci.org/lodash/">CI</a> test runs are available.</p>
</section>
{% raw %}
<script>addEventListener("load",function(){var t=document,e="bestiejs",a="lodash",r="social",n="Check out lodash – A JavaScript utility library delivering consistency, modularity, performance, %26 extras",s=t.getElementById(r);if(navigator.onLine){var l="iframe",o="frameborder=0 scrolling=0 allowtransparency",i="https://platform.twitter.com/widgets",d='class="btn-gh" src="https://ghbtns.com/github-btn.html?user=lodash&repo=lodash&count=true&type=',p="dnt=true&screen_name="+e+"&show_count=false&size=m",m="dnt=true&counturl=https://"+a+".com&dnt=true&show_count=true&size=m&text="+n+"&url=https://"+a+".com/",s=t.getElementById(r),c=t.createElement("div");c.innerHTML="<"+l+" "+o+" "+d+'star"></'+l+"><"+l+" "+o+" "+d+'fork"></'+l+"><"+l+" "+o+' class="btn-twitter-follow" src="'+i+"/follow_button.html?"+encodeURI(p)+'"></'+l+"><"+l+" "+o+' class="btn-twitter-share" src="'+i+"/tweet_button.html?"+encodeURI(m).replace(/%25/g,"%")+'"></'+l+">",s.appendChild(c.firstChild),s.appendChild(c.firstChild),s.appendChild(c.firstChild),s.appendChild(c.firstChild)}else s.parentNode.style.display="none"})</script>
{% endraw %}