1: <?php
2:
3: /**
4: * Picon Framework
5: * http://code.google.com/p/picon-framework/
6: *
7: * Copyright (C) 2011-2012 Martin Cassidy <martin.cassidy@webquub.com>
8:
9: * Picon Framework is free software: you can redistribute it and/or modify
10: * it under the terms of the GNU General Public License as published by
11: * the Free Software Foundation, either version 3 of the License, or
12: * (at your option) any later version.
13:
14: * Picon Framework is distributed in the hope that it will be useful,
15: * but WITHOUT ANY WARRANTY; without even the implied warranty of
16: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17: * General Public License for more details.
18:
19: * You should have received a copy of the GNU General Public License
20: * along with Picon Framework. If not, see <http://www.gnu.org/licenses/>.
21: * */
22:
23: namespace picon;
24:
25: /**
26: * A component whose mark-up is rendered multiple times based on some form
27: * of repitition
28: *
29: * @author Martin Cassidy
30: * @package web/markup/html/repeater
31: */
32: abstract class AbstractRepeater extends MarkupContainer
33: {
34: public function __construct($id, $model = null)
35: {
36: if($model!=null && !($model instanceof ArrayModel) && gettype($model->getModelObject())!=Component::TYPE_ARRAY)
37: {
38: throw new \InvalidArgumentException('List View must have an Array Model or a model of an array');
39: }
40: if($model==null)
41: {
42: parent::__construct($id);
43: }
44: else
45: {
46: parent::__construct($id, $model);
47: }
48: }
49:
50: /**
51: * Sub classes should implement this method to return
52: * an array of all of the child to be rendered
53: */
54: protected abstract function getRenderArray();
55:
56: protected function onRender()
57: {
58: $components = $this->getRenderArray();
59: Args::isArray($components, 'getRenderArray return value');
60: foreach($components as $index => $component)
61: {
62: $this->renderChild($component);
63: }
64: }
65:
66: protected function renderChild(Component $child)
67: {
68: $child->render();
69: }
70:
71: public function getMarkupForChild(Component $child)
72: {
73: return $this->getMarkup();
74: }
75:
76: public function beforePageRender()
77: {
78: parent::beforePageRender();
79: $this->populate();
80: }
81:
82: protected abstract function populate();
83: }
84:
85: ?>
86: