allow using sections as context. Patch by dpree.

CHANGES.md

@@ -1,9 +1,11 @@
 # mustache.js Changes
 
 ## 0.3.0 (??-??-????)
+* Use sections to dereference subcontexts.
 * Added higher order sections.
 
 
+
 ## 0.2.3 (28-03-2010)
 
 * Better error message for missing partials.

README.md

@@ -115,6 +115,40 @@ implement caching, filters (like syntax highlighting), etc.
 
 You can use `this.name` to access the attribute `name` from your view.
 
+### Dereferencing Section
+
+If you have a nested object structure in your view, it can sometimes be easier
+to use sections like this:
+
+    var objects = {
+      a_object: {
+        title: 'this is an object',
+        description: 'one of its attributes is a list',
+        a_list: [{label: 'listitem1'}, {label: 'listitem2'}]
+      }
+    };
+
+This is our template:
+
+    {{#a_object}}
+      <h1>{{title}}</h1>
+      <p>{{description}}</p>
+      <ul>
+        {{#a_list}}
+          <li>{{label}}</li>
+        {{/a_list}}
+      </ul>
+    {{/a_object}}
+
+Here is the result:
+
+    <h1>this is an object</h1>
+      <p>one of its attributes is a list</p>
+      <ul>
+        <li>listitem1</li>
+        <li>listitem2</li>
+      </ul>
+
 
 ### View Partials
 

examples/section_as_context.html

@@ -0,0 +1,9 @@
+{{#a_object}}
+  <h1>{{title}}</h1>
+  <p>{{description}}</p>
+  <ul>
+    {{#a_list}}
+      <li>{{label}}</li>
+    {{/a_list}}
+  </ul>
+{{/a_object}}

examples/section_as_context.js

@@ -0,0 +1,7 @@
+var section_as_context = {
+  a_object: {
+    title: 'this is an object',
+    description: 'one of its attributes is a list',
+    a_list: [{label: 'listitem1'}, {label: 'listitem2'}]
+  }
+};

examples/section_as_context.txt

@@ -0,0 +1,6 @@
+<h1>this is an object</h1>
+  <p>one of its attributes is a list</p>
+  <ul>
+    <li>listitem1</li>
+    <li>listitem2</li>
+    </ul>

mustache.js

@@ -109,6 +109,9 @@ var Mustache = function() {
             return that.render(content, that.merge(context,
                     that.create_context(row)), partials, true);
           }).join("");
+        } else if(that.is_object(value)) { // Object, Use it as subcontext!
+          return that.render(content, 
+            that.merge(context, that.create_context(value)), partials, true);
         } else if(typeof value === "function") {
           // higher order section
           return value.call(context, content, function(text) {