ENH Looping through arrays in templates

src/View/SSViewer_DataPresenter.php

@@ -172,6 +172,10 @@ public function getInjectedValue($property, array $params, $cast = true)
         // Get source for this value
         $result = $this->getValueSource($property);
         if (!array_key_exists('source', $result)) {
+            // $Me is a special property. If nothing is providing an override, return the current item.
+            if ($property === 'Me') {
+                return ['obj' => $this->getItem()];
+            }
             return null;
         }
 

src/View/SSViewer_Scope.php

@@ -130,6 +130,16 @@ public function getItem()
         if (is_scalar($item)) {
             $item = $this->convertScalarToDBField($item);
         }
+        // Wrap arrays
+        if (is_array($item)) {
+            if (array_is_list($item)) {
+                // Wrap in ArrayIterator to respect method signature
+                $item = new ArrayIterator($item);
+            } else {
+                // Wrap in ArrayData so values can be accessed by key in templates
+                $item = ArrayData::create($item);
+            }
+        }
         return $item;
     }
 
@@ -308,6 +318,8 @@ public function next()
             // Item may be an array or a regular IteratorAggregate
             if (is_array($this->item)) {
                 $this->itemIterator = new ArrayIterator($this->item);
+            } elseif ($this->item instanceof Iterator) {
+                $this->itemIterator = $this->item;
             } else {
                 $this->itemIterator = $this->item->getIterator();
 

src/View/ViewableData.php

@@ -537,7 +537,7 @@ protected function objCacheClear()
      * @param array $arguments
      * @param bool $cache Cache this object
      * @param string $cacheName a custom cache name
-     * @return Object|DBField
+     * @return object|DBField
      */
     public function obj($fieldName, $arguments = [], $cache = false, $cacheName = null)
     {
@@ -558,6 +558,17 @@ public function obj($fieldName, $arguments = [], $cache = false, $cacheName = nu
             $value = $this->$fieldName;
         }
 
+        // Wrap arrays
+        if (is_array($value)) {
+            if (array_is_list($value)) {
+                // Wrap in ArrayIterator to respect method signature
+                $value = new ArrayIterator($value);
+            } else {
+                // Wrap in ArrayData so values can be accessed by key in templates
+                $value = ArrayData::create($value);
+            }
+        }
+
         // Cast object
         if (!is_object($value)) {
             // Force cast
@@ -668,17 +679,6 @@ public function getViewerTemplates($suffix = '')
         return SSViewer::get_templates_by_class(static::class, $suffix, self::class);
     }
 
-    /**
-     * When rendering some objects it is necessary to iterate over the object being rendered, to do this, you need
-     * access to itself.
-     *
-     * @return ViewableData
-     */
-    public function Me()
-    {
-        return $this;
-    }
-
     /**
      * Get part of the current classes ancestry to be used as a CSS class.
      *