ractive

Getting Ractive.js

The easiest way to download the latest released version of Ractive is to grab it from http://cdn.ractivejs.org/latest/{filename}.js, where {filename} is one of

• ractive.js
• ractive.min.js - minified version
• ractive-legacy.js - IE8 compatible
• ractive-legacy.min.js
• ractive.runtime.js - excludes Ractive.parse() - assumes templates are parsed on the server or during build
• ractive.runtime.min.js
• ractive-legacy.runtime.js
• ractive-legacy.runtime.min.js

If you'd like to get the most recent version, substitute 'edge' for 'latest' in the URL, e.g. http://cdn.ractivejs.org/edge/ractive.js. These builds have passed the tests but may include experimental features, so should not be used in production.

For specific stable releases, replace 'latest' with e.g. '0.5.0'.

Installing with bower

If you use bower for frontend package management, you can do

$ bower install ractive

To download the edge version, use the edge tag:

$ bower install ractive#edge

(If you want to redownload it, you may need to clean bower's cache with bower cache clean ractive.)

Installing with npm

$ npm install ractive

Starting with 0.4.0, releases live on the build branch. It's therefore possible to npm install the most recent builds straight from GitHub:

$ npm install git://github.com/ractivejs/ractive.git#v0.4.1-pre

(The v0.4.1-pre tag - which will change after each stable release - is equivalent to the edge tag, but npm requires valid semver tags.)

Changelog

0.6.0

2014-09-29

• Breaking changes:
  • new Ractive() now inherits all options as methods/properties including event hooks.
  • The deprecated init() function (see below) is mapped to onrender() and will fire more than once, and no longer contains options argument
  • New reserved events (see below)
  • Setting uninitialised data on a component will no longer cause it to leak out into the parent scope
  • 'Smart updates', via ractive.merge() and ractive.shift() etc, work across component boundaries
• Deprecated:
  • beforeInit(), init(), and complete() - replaced with onconstruct(), onrender() and oncomplete() methods
• New features
  • Event hooks: onconstruct(), onconfig(), oninit(), onrender(), oncomplete(), onunrender(), onteardown(). These all have equivalent events, e.g. this.on('render',...), which are reserved (i.e. you cannot use them as proxy events in templates)
  • Conditional attributes, e.g. <div {{#if selected}}class='selected'{{/if}}>...</div>
  • Safe to specify touch events for browsers that do not support them
  • Added support for {{else}} in {{#with}} block
  • Added support for {{#each...}}...{{else}}...{{/each}} with empty objects (#1299)
  • Within event handlers, the event object is available __/25/2020as this.event, and has a name property (useful alongside ractive.on('*',...)).
  • Character position is include alongside line and column information when parsing with includeLinePositions: true
  • Computed values and expressions are more efficient, and will not recompute unnecessarily
• Fixes for #868, #871, #1046, #1184, #1206, #1208, #1209, #1220, #1228, #1232, #1239, #1275, #1278, #1294, #1295, #1305, #1313, #1314, #1320 plus a few IE8 bugs