CHANGELOG.md

0.9.6

No changes (version bump due to error in publishing 0.9.5)

0.9.5

Changes

• Use global object $ (jQuery or jQuery alternative) if available, fixing #646

0.9.4

Changes

• Updated sightglass to v0.2.6, fixing #572

0.9.2

Changes

• Fix issue when resetting a model #644
• Fix publish function in two-way formatters #649
• Fix array binding #650
• Fix observers on prototype functions #572

0.9.1

Changes

• Fix bug in expression with multiple strings #620

0.9.0

Changes

• Fix binders which received 0 instead of undefined when HTML attributes were empty #567
• Now functions are not executed by Rivets in expressions. To call the function you need to use the call formatter. See documentation here #571
• Support for nested rv-each with an index for each iteration. Index names can be configured, see documentation here #551
• Support for pipes in quoted arguments #432
• Support for constant string in component HTML attributes #478
• Fix rebind bug when a templated used nested rv-if binders #611

Upgrading from 0.8

• Since 0.9 Rivets will not execute functions by default. This will allow passing arguments to function with the call formatter.

  • Calling function in 0.8

  { item.myFunction }
  

  • Calling function in 0.9

  { item.myFunction | call}
  

  • Calling function in 0.9 with arguments

  { item.myFunction | call myArgument 'argument as string'}
  

  • You can force function executions to have your application work in 0.9 without using the call formatter. This is done with the configuration

  rivets.configure({
      // Since rivets 0.9 functions are not automatically executed in expressions. If you need backward compatibilty, set this parameter to true
      executeFunctions: true
  });
  

• Using multiple indexes in nested rv-each. Since 0.9 rivets allows to have a specific index variable for each iteration.

  <ul>
    <li rv-each-todo="todos">
      <ul>
        <li rv-each-item="todo.items">
          <span>item #{ %item% } in todo #{ %todo%}</span>
          <!-- Here the index will be the same as %item% -->
        </li>
      </ul>
    </li>
  <ul>
  

  The index is still available for compatibility reasons but you must be aware that it will only represent the last iteration.

0.8

Changes

• More refined and useful components API. Some documentation is available here.

0.7

Changes

• Support for data-bound keypaths are formatter arguments.

  { item.price | lte user.balance }
  

• Support for primitives in binding declarations. This includes strings, numbers, booleans, null and undefined.

  { item.updated | date 'MMM DD, YYY' }
  

• Primitives are also supported as the binding target.

  { 'i18n.errors.' | append error | translate }
  

• Support for multiple binder arguments (wildcard matches). See #383.

• The Observer class has been abstracted out into a new lib as a dependency. See Sightglass.

• The built-in value binder now listens on the input event instead of change, so updates will propogate immediately instead of on blur.

• There is no more rivets.config object. All of the previous configuration options are defined on the module directly.

• If a template includes <script> elements, they will now be ignored when the template is parsed.

Upgrading from 0.6

• Make sure you include the sightglass lib in your project. Just include sightglass.js before rivets.js. Alternatively you can just include rivets.bundled.min.js once (contains both libraries).

• If you have defined any custom adapters, they will need to be updated from the old property names to the new property names.

  • adapter.subscribe is now adapter.observe.
  • adapter.unsubscribe is now adapter.unobserve.
  • adapter.read is now adapter.get.
  • adapter.publish is now adapter.set.

• Change all of your existing formatter arguments to be wrapped in quotes. This is because arguments are evaluated as keypaths by default (unless they are wrapped in quotes).

  • For example, if you were previously doing the following:

    <p>{ item.enabled | switch green red }</p>

    You will need to change it to:

    <p>{ item.enabled | switch 'green' 'red' }</p>

  • Note that if your keypath argument was a number, true, false, null or undefined, then you can leave them without quotes, but they will be passed to the formatter as the actual primitive value instead of a string.

• If you ever set properties directly on the rivets.config object, you will need to change those to the rivets object itself.

  • For example, if you were previously doing the following:

    rivets.config.templateDelimiters = ['{{', '}}']

    You will need to change it to:

    rivets.templateDelimiters = ['{{', '}}']

  • Note that if you were only using rivets.configure({}) then no changes are needed (rivets.configure functions the same as before).

0.6

Changes

• Support for multiple adapters through interfaces.
• Ships with a built-in . adapter using ES5 natives (getters and setters).
• Support for nested keypaths (user.address:zip).

Upgrading from 0.5

• All dependencies now stem from the target object, not the view's scope object. Make sure to change all dependency keypaths so that they stem from the object that points to the computed property / function.
• The prefix configuration is now an absolute prefix (you need to include "data" in the prefix if you want to use data attributes). Defaults to rv. Make sure to change all existing attribute names to rv-[binder] or update your prefix configuration option.

Caveats

• The built-in adapter observes array mutations (push, pop, unshift, etc.) but not changes made to indexes on the array directly (array[3] = 'world' for example).
• The built-in adapter cannot subscribe to an array's length property. Currently you need to use a formatter to access the array's length property (list.items | length).