Added @index for objects to #each helper.

[joelmoss]

Currently the @index is only returned when looping through an array with the @each helper. This PR also returns @index when looping through objects as well.

[mpetrovich]

When traversing over an object in JavaScript, you're not guaranteed that the properties will be traversed in a particular (or even repeatable) order. The ECMA standard doesn't specify how object properties should be traversed—browsers might traverse them in order of their insertion or in numerical order, and there's variance between different browsers.

What's your use case?

[joelmoss]

The use case is the same as the use case when using an Array, and could include being able to know when it is the first or last item in the object. It just make sense that Array's have it, but Objects don't.

[mpetrovich]

There's no such thing of the "first" or "last" property of an object in JavaScript. Objects in JavaScript are, in a mathematical sense, sets of properties with no intrinsic order. How would you do this with pure JS? (and without writing 2 loops)

[joelmoss]

@index == 0 == first
@index == object.length == last

[kpdecker]

Is zero-based the proper thing here? Wouldn't the common use case be to display one-based numbering to the user?

[joelmoss]

I'm trying to keep it consistent with arrays.

[bolshchikov]

Handlebars doesn't parse @Index correctly. Any ideas why?
http://jsbin.com/eqasax/2/edit

[sulphur]

+1

[thom4parisot]

When iterating on objects, what is important is the @index value of the returned object in the loop.

My actual use case to display a clearfix for Bootstrap 3 every 4 items, to ensure a proper line return for various viewport size:

<div class="row">
  {{#each games}}
  <div class="col-sm-3">
    <h2><a href="/games/{{slug}}/">{{title}}</a></h2>
  </div>

  {{#eq @index 4}} <div class="clearfix"></div> {{/eq}}
  {{/each}}
</div>

With :

var games = {
  "barbie-super-model": {
    "title": "Barbie Super Model",
    "reviews_count": 1,
    "rating": 0.5
  },
  "donkey-kong-country-2-diddy-s-kong-quest": {
    "title": "Donkey Kong Country 2 : Diddy's Kong Quest",
    "alternate_titles": [
      "DKC2",
      "DKC II"
    ],
    "editor": "RARE",
    "reviews_count": 1,
    "rating": 5
  }
}

[kpdecker]

Implemented by #661 which was easier to merge.