Attr.php
4.65 KB
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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
<?php
/**
* PHPTAL templating engine
*
* PHP Version 5
*
* @category HTML
* @package PHPTAL
* @author Laurent Bedubourg <lbedubourg@motion-twin.com>
* @author Kornel Lesiński <kornel@aardvarkmedia.co.uk>
* @license http://www.gnu.org/licenses/lgpl.html GNU Lesser General Public License
* @version SVN: $Id: Attr.php 715 2009-09-14 22:57:56Z kornel $
* @link http://phptal.org/
*/
/**
* node that represents element's attribute
*
* @package PHPTAL
* @subpackage Dom
*/
class PHPTAL_Dom_Attr
{
private $value_escaped, $qualified_name, $namespace_uri, $encoding;
/**
* attribute's value can be overriden with a variable
*/
private $phpVariable;
const HIDDEN = -1;
const NOT_REPLACED = 0;
const VALUE_REPLACED = 1;
const FULLY_REPLACED = 2;
private $replacedState = 0;
/**
* @param string $qualified_name attribute name with prefix
* @param string $namespace_uri full namespace URI or empty string
* @param string $value_escaped value with HTML-escaping
* @param string $encoding character encoding used by the value
*/
function __construct($qualified_name, $namespace_uri, $value_escaped, $encoding)
{
$this->value_escaped = $value_escaped;
$this->qualified_name = $qualified_name;
$this->namespace_uri = $namespace_uri;
$this->encoding = $encoding;
}
/**
* get character encoding used by this attribute.
*/
public function getEncoding()
{
return $this->encoding;
}
/**
* get full namespace URI. "" for default namespace.
*/
function getNamespaceURI()
{
return $this->namespace_uri;
}
/**
* get attribute name including namespace prefix, if any
*/
function getQualifiedName()
{
return $this->qualified_name;
}
/**
* get "foo" of "ns:foo" attribute name
*/
function getLocalName()
{
$n = explode(':', $this->qualified_name,2);
return end($n);
}
/**
* Returns true if this attribute is ns declaration (xmlns="...")
*
* @return bool
*/
function isNamespaceDeclaration()
{
return preg_match('/^xmlns(?:$|:)/',$this->qualified_name);
}
/**
* get value as plain text
*
* @return string
*/
function getValue()
{
return html_entity_decode($this->value_escaped, ENT_QUOTES, $this->encoding);
}
/**
* set plain text as value
*/
function setValue($val)
{
$this->value_escaped = htmlspecialchars($val);
}
/**
* Depends on replaced state.
* If value is not replaced, it will return it with HTML escapes.
*
* @see getReplacedState()
* @see overwriteValueWithVariable()
*/
function getValueEscaped()
{
return $this->value_escaped;
}
/**
* Set value of the attribute to this exact string.
* String must be HTML-escaped and use attribute's encoding.
*
* @param string $value_escaped new content
*/
function setValueEscaped($value_escaped)
{
$this->replacedState = self::NOT_REPLACED;
$this->value_escaped = $value_escaped;
}
/**
* set PHP code as value of this attribute. Code is expected to echo the value.
*/
private function setPHPCode($code)
{
$this->value_escaped = '<?php '.$code.' ?>';
}
/**
* hide this attribute. It won't be generated.
*/
function hide()
{
$this->replacedState = self::HIDDEN;
}
/**
* generate value of this attribute from variable
*/
function overwriteValueWithVariable($phpVariable)
{
$this->replacedState = self::VALUE_REPLACED;
$this->phpVariable = $phpVariable;
$this->setPHPCode('echo '.$phpVariable);
}
/**
* generate complete syntax of this attribute using variable
*/
function overwriteFullWithVariable($phpVariable)
{
$this->replacedState = self::FULLY_REPLACED;
$this->phpVariable = $phpVariable;
$this->setPHPCode('echo '.$phpVariable);
}
/**
* use any PHP code to generate this attribute's value
*/
function overwriteValueWithCode($code)
{
$this->replacedState = self::VALUE_REPLACED;
$this->phpVariable = NULL;
$this->setPHPCode($code);
}
/**
* if value was overwritten with variable, get its name
*/
function getOverwrittenVariableName()
{
return $this->phpVariable;
}
/**
* whether getValueEscaped() returns real value or PHP code
*/
function getReplacedState()
{
return $this->replacedState;
}
}