vndb/mithril-vndb
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

fix broken link

Browse source
This commit is contained in:
Leo Horie 2014-11-14 20:47:18 -05:00
parent 940289773e
commit 8792714c0b
2 changed files with 123 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

2
Gruntfile.js
View file

@ -13,7 +13,7 @@ module.exports = function(grunt) {
"auto-redrawing",
"benchmarks",
"community",
"compiling-templates",
"optimizing-performance",
"comparison",
"components",
"getting-started",

122
archive/v0.1.24/optimizing-performance.html Normal file
View file

@ -0,0 +1,122 @@
<!doctype html>
<html>
<head>
<title>Mithril</title>
<link href="lib/prism/prism.css" rel="stylesheet" />
<link href="style.css" rel="stylesheet" />
</head>
<body>
<header>
<nav class="container">
<a href="index.html" class="logo"><span>&#9675;</span> Mithril</a>
<a href="getting-started.html">Guide</a>
<a href="mithril.html">API</a>
<a href="community.html">Community</a>
<a href="http://lhorie.github.io/mithril-blog">Learn</a>
<a href="mithril.min.zip">Download</a>
<a href="http://github.com/lhorie/mithril.js" target="_blank">Github</a>
</nav>
</header>
<main>
<section class="content">
<div class="container">
<div class="row">
<div class="col(3,3,12)">
<h2 id="core-topics">Core Topics</h2>
<ul>
<li><a href="installation.html">Installation</a></li>
<li><a href="getting-started.html">Getting Started</a></li>
<li><a href="routing.html">Routing</a></li>
<li><a href="web-services.html">Web Services</a></li>
<li><a href="components.html">Components</a></li>
</ul>
<h2 id="advanced-topics.html">Advanced Topics</h2>
<ul>
<li><a href="auto-redrawing.html">The Auto-Redrawing System</a></li>
<li><a href="integration.html">Integrating with Other Libraries</a></li>
<li><a href="optimizing-performance.html">Compiling Templates</a></li>
</ul>
<h2 id="misc">Misc</h2>
<ul>
<li><a href="comparison.html">Differences from Other MVC Frameworks</a></li>
<li><a href="benchmarks.html">Benchmarks</a></li>
<li><a href="practices.html">Good Practices</a></li>
<li><a href="tools.html">Useful Tools</a></li>
</ul>
</div>
<div class="col(9,9,12)">
<h2 id="optimizing-performance">Optimizing Performance</h2>
<p>There&#39;s a number of ways to improve Mithril performance for the rare cases where pages are too complex for their own good.</p>
<p>First and foremost, you should think hard about whether performance optimization is truly your last resort. By nature, optimizing performance make aggressive assumptions that can break in edge cases and it yields difficult to understand code. As a rule of thumb, you should <em>never</em> implement performance optimizations if another solution is available.</p>
<p>For example, if you are building a table with thousands of rows and finding that the template is slow, you should first consider making the table show less items, because from a user experience perspective, no one is realistically going to scan through thousands of records. The effort to make the table paginated, searchable or filterable can improve the user experience in addition to solving the performance problem both on redraws and on initial page load.</p>
<hr>
<h2 id="compiling-templates">Compiling templates</h2>
<p>You can optionally pre-compile templates that use <code>m()</code> by running the <a href="tools/template-compiler.sjs"><code>template-compiler.sjs</code></a> macro with <a href="https://github.com/mozilla/sweet.js">Sweet.js</a>. This step isn&#39;t required in order to use Mithril, but it&#39;s an easy way to squeeze a little bit more performance out of an application, without the need for code changes.</p>
<p>Compiling a template transforms the nested function calls of a template into a raw virtual DOM tree (which is merely a collection of native Javascript objects that is ready to be rendered via <a href="mithril.render.html"><code>m.render</code></a>). This means that compiled templates don&#39;t need to parse the string in <code>m(&quot;div#foo&quot;)</code> and they don&#39;t incur the cost of the function call.</p>
<p>It&#39;s worth mentioning that Mithril has built-in mechanisms elsewhere that take care of real bottlenecks like browser repaint management and DOM updating. This optional compilation tool is merely &quot;icing on the cake&quot; that speeds up the Javascript run-time of templates (which is already fast, even without compilation - see the <a href="http://lhorie.github.io/mithril/index.html#performance">performance section on the homepage</a>).</p>
<p>The macro takes regular Mithril templates like the one below:</p>
<pre><code class="lang-javascript">var view = function() {
return m(&quot;a&quot;, {href: &quot;http://google.com&quot;}, &quot;test&quot;);
}
</code></pre>
<p>It pre-processes the <code>m()</code> call and replaces it with its output:</p>
<pre><code class="lang-javascript">var view = function() {
return {tag: &quot;a&quot;, attrs: {href: &quot;http://google.com&quot;}, children: &quot;test&quot;};
}
</code></pre>
<p>Note that compiled templates are meant to be generated by an automated build process and are not meant to be human editable.</p>
<hr>
<h3 id="installing-nodejs-and-sweetjs-for-one-off-compilations">Installing NodeJS and SweetJS for one-off compilations</h3>
<p>SweetJS requires a <a href="http://nodejs.org">NodeJS</a> environment. To install it, go to its website and use the installer provided.</p>
<p>To install SweetJS, NodeJS provides a command-line package manager tool. In a command line, type:</p>
<pre><code>npm install -g sweet.js
</code></pre><p>To compile a file, type:</p>
<pre><code>sjs -r -m /template-compiler.sjs -o &lt;output-filename&gt;.js &lt;input-filename&gt;.js
</code></pre><hr>
<h3 id="automating-compilation">Automating Compilation</h3>
<p>If you want to automate compilation, you can use <a href="http://gruntjs.com">GruntJS</a>, a task automation tool. If you&#39;re not familiar with GruntJS, you can find a tutorial on their website.</p>
<p>Assuming NodeJS is already installed, run the following command to install GruntJS:</p>
<pre><code>npm install -g grunt-cli
</code></pre><p>Once installed, create two files in the root of your project, <code>package.json</code> and <code>Gruntfile.js</code></p>
<p><code>package.json</code></p>
<pre><code class="lang-javascript">{
&quot;name&quot;: &quot;project-name-goes-here&quot;,
&quot;version&quot;: &quot;0.0.0&quot;, //must follow this format
&quot;devDependencies&quot;: {
&quot;grunt-sweet.js&quot;: &quot;*&quot;
}
}
</code></pre>
<p><code>Gruntfile.js</code></p>
<pre><code class="lang-javascript">module.exports = function(grunt) {
grunt.initConfig({
sweetjs: {
modules: [&quot;template-compiler.sjs&quot;],
compile: {expand: true, cwd: &quot;.&quot;, src: &quot;**/*.js&quot;, dest: &quot;destination-folder-goes-here/&quot;}
}
});
grunt.loadNpmTasks(&#39;grunt-sweet.js&#39;);
grunt.registerTask(&#39;default&#39;, [&#39;sweetjs&#39;]);
}
</code></pre>
<p>Make sure to replace the <code>project-name-goes-here</code> and <code>destination-folder-goes-here</code> placeholders with appropriate values.</p>
<p>To run the automation task, run the following command from the root folder of your project:</p>
<pre><code>grunt
</code></pre><p>More documentation on the grunt-sweet.js task and its options <a href="https://github.com/natefaubion/grunt-sweet.js">can be found here</a></p>
</div>
</div>
</div>
</section>
</main>
<footer>
<div class="container">
Released under the <a href="http://opensource.org/licenses/MIT" target="_blank">MIT license</a>
<br />&copy; 2014 Leo Horie
</div>
</footer>
<script src="lib/prism/prism.js"></script>
</body>
</html>