/
Collection.php
120 lines (113 loc) · 3.33 KB
/
Collection.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
<?php namespace webmaxx\materialize;
use yii\helpers\Html;
/**
* Button renders a materialize button.
*
* For example,
*
* ```php
* echo Collection::widget([
* 'options' => [
* 'class' => 'with-header',
* ],
* 'items' => [
* ['label' => Html::tag('h4', 'header'), 'type' => 'header'],
* ['label' => 'test'],
* ['label' => 'test2'],
* ],
* ]);
* ```
* or
*
* ```php
* echo Collection::widget([
* 'tagName' => 'div',
* 'itemTagName' => 'a',
* 'items' => [
* ['label' => 'test', 'options' => ['href' => '/']],
* ['label' => 'test2', 'options' => ['href' => '/', 'class' => 'active']],
* ['label' => 'test3', 'options' => ['href' => '/']],
* ],
* ]);
* ```
* @see http://materializecss.com/collections.html
* @author webmaxx <webmaxx@webmaxx.name>
* @since 2.0
*/
class Collection extends Widget
{
/**
* @var string the tag to use to render the collection
*/
public $tagName = 'ul';
/**
* @var array list of items. Each array element represents a single item
* which can be specified as a string or an array of the following structure:
*
* - label: string, required, the button label.
* - options: array, optional, the HTML attributes of the button.
*/
public $items = [];
/**
* @var string the tag to use to render the collection item
*/
public $itemTagName = 'li';
/**
* @var boolean whether to HTML-encode the item labels.
*/
public $encodeLabels = true;
/**
* @var string default css class for collection
*/
public $defaultClass = 'collection';
/**
* Initializes the widget.
* If you override this method, make sure you call the parent implementation first.
*/
public function init()
{
parent::init();
$this->clientOptions = false;
if ($this->defaultClass)
Html::addCssClass($this->options, $this->defaultClass);
}
/**
* Renders the widget.
*/
public function run()
{
MaterializeAsset::register($this->getView());
return Html::tag($this->tagName, $this->renderItems(), $this->options);
}
/**
* Generates the buttons that compound the group as specified on [[buttons]].
* @return string the rendering result.
*/
protected function renderItems()
{
$buttons = [];
foreach ($this->items as $item) {
if (is_array($item)) {
$item['view'] = $this->getView();
if (!isset($item['tagName'])) {
$item['tagName'] = $this->itemTagName;
}
if (!isset($item['encodeLabel'])) {
$item['encodeLabel'] = $this->encodeLabels;
}
if (!isset($item['type'])) {
Html::addCssClass($item['options'], 'collection-item');
} else {
Html::addCssClass($item['options'], 'collection-' . $item['type']);
}
if (!isset($item['options'])) {
$item['options'] = [];
}
$items[] = Html::tag($item['tagName'], $item['label'], $item['options']);
} else {
$items[] = $item;
}
}
return implode("\n", $items);
}
}