1 | <?php |
||
7 | trait HasLabelTrait |
||
8 | { |
||
9 | |||
10 | 2 | protected function ensureLabelAttributes() |
|
11 | { |
||
12 | 2 | if (!isset($this[Specs::LABEL_ATTRIBUTES])) { |
|
13 | 2 | $this[Specs::LABEL_ATTRIBUTES] = new AttributesContainer(); |
|
14 | 2 | } |
|
15 | 2 | } |
|
16 | |||
17 | /** |
||
18 | * Retrieves the label's text |
||
19 | * |
||
20 | * @return string null |
||
21 | */ |
||
22 | 6 | public function getLabel() |
|
23 | { |
||
24 | 6 | return isset($this[Specs::LABEL]) ? $this[Specs::LABEL] : null; |
|
25 | } |
||
26 | |||
27 | /** |
||
28 | * Sets the label's text |
||
29 | * |
||
30 | * @param string $label |
||
31 | * |
||
32 | * @return self |
||
33 | */ |
||
34 | 2 | public function setLabel($label) |
|
40 | |||
41 | /** |
||
42 | * Retrieve all of the label's attributes |
||
43 | * |
||
44 | * @return mixed |
||
45 | */ |
||
46 | 1 | public function getLabelAttributes() |
|
52 | |||
53 | /** |
||
54 | * Sets multiple attributes for the label |
||
55 | * |
||
56 | * @param array $attrs |
||
57 | * |
||
58 | * @return HasLabelTrait |
||
|
|||
59 | */ |
||
60 | 1 | public function setLabelAttributes($attrs) |
|
61 | { |
||
62 | 1 | $this->ensureLabelAttributes(); |
|
63 | 1 | $this[Specs::LABEL_ATTRIBUTES]->set($attrs); |
|
64 | |||
65 | 1 | return $this; |
|
66 | } |
||
67 | |||
68 | /** |
||
69 | * Retrieve an attribute from the label |
||
70 | * |
||
71 | * @param string $attr |
||
72 | * |
||
73 | * @return mixed |
||
74 | */ |
||
75 | 2 | public function getLabelAttribute($attr) |
|
81 | |||
82 | /** |
||
83 | * Set/Unset a label attribute |
||
84 | * |
||
85 | * @param string $attr |
||
86 | * @param mixed|null $value |
||
87 | * |
||
88 | * @return self |
||
89 | */ |
||
90 | 1 | public function setLabelAttribute($attr, $value = null) |
|
97 | |||
98 | /** |
||
99 | * Adds a CSS class to the label's "class" attribute |
||
100 | * |
||
101 | * @param string $class |
||
102 | * |
||
103 | * @return self |
||
104 | */ |
||
105 | 1 | public function addLabelClass($class) |
|
112 | |||
113 | /** |
||
114 | * Removes a CSS class from the label's "class" attribute |
||
115 | * |
||
116 | * @param string $class |
||
117 | * |
||
118 | * @return self |
||
119 | */ |
||
120 | 1 | public function removeLabelClass($class) |
|
127 | |||
128 | /** |
||
129 | * Toggles a CSS class to the label's "class" attribute |
||
130 | * |
||
131 | * @param |
||
132 | * $class |
||
133 | * |
||
134 | * @return self |
||
135 | */ |
||
136 | 1 | public function toggleLabelClass($class) |
|
143 | |||
144 | /** |
||
145 | * Checks if the label has a CSS class on the "class" attribute |
||
146 | * |
||
147 | * @param |
||
148 | * $class |
||
149 | * |
||
150 | * @return bool |
||
151 | */ |
||
152 | 1 | public function hasLabelClass($class) |
|
158 | } |
||
159 |
In PHP traits cannot be used for type-hinting as they do not define a well-defined structure. This is because any class that uses a trait can rename that trait’s methods.
If you would like to return an object that has a guaranteed set of methods, you could create a companion interface that lists these methods explicitly.