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
|
<?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$
* @link http://phptal.org/
*/
/**
* METAL Specification 1.0
*
* argument ::= expression
*
* Example:
*
* <hr />
* <p metal:use-macro="here/master_page/macros/copyright">
* <hr />
*
* PHPTAL: (here not supported)
*
* <?php echo phptal_macro( $tpl, 'master_page.html/macros/copyright'); ? >
*
*
*
* @package PHPTAL
* @subpackage Php.attribute.metal
* @author Laurent Bedubourg <lbedubourg@motion-twin.com>
*/
class PHPTAL_Php_Attribute_METAL_UseMacro extends PHPTAL_Php_Attribute
{
static $ALLOWED_ATTRIBUTES = array(
'fill-slot'=>'http://xml.zope.org/namespaces/metal',
'define-macro'=>'http://xml.zope.org/namespaces/metal',
'define'=>'http://xml.zope.org/namespaces/tal',
);
public function before(PHPTAL_Php_CodeWriter $codewriter)
{
$this->pushSlots($codewriter);
foreach ($this->phpelement->childNodes as $child) {
$this->generateFillSlots($codewriter, $child);
}
$macroname = strtr($this->expression, '-', '_');
// throw error if attempting to define and use macro at same time
// [should perhaps be a TemplateException? but I don't know how to set that up...]
if ($defineAttr = $this->phpelement->getAttributeNodeNS(
'http://xml.zope.org/namespaces/metal', 'define-macro')) {
if ($defineAttr->getValue() == $macroname)
throw new PHPTAL_TemplateException("Cannot simultaneously define and use macro '$macroname'",
$this->phpelement->getSourceFile(), $this->phpelement->getSourceLine());
}
// local macro (no filename specified) and non dynamic macro name
// can be called directly if it's a known function (just generated or seen in previous compilation)
if (preg_match('/^[a-z0-9_]+$/i', $macroname) && $codewriter->functionExists($macroname)) {
$code = $codewriter->getFunctionPrefix() . $macroname . '($_thistpl, $tpl)';
$codewriter->pushCode($code);
}
// external macro or ${macroname}, use PHPTAL at runtime to resolve it
else {
$code = $codewriter->interpolateTalesVarsInString($this->expression);
$codewriter->pushCode('$tpl->_executeMacroOfTemplate('.$code.', $_thistpl)');
}
$this->popSlots($codewriter);
}
public function after(PHPTAL_Php_CodeWriter $codewriter)
{
}
/**
* reset template slots on each macro call ?
*
* NOTE: defining a macro and using another macro on the same tag
* means inheriting from the used macro, thus slots are shared, it
* is a little tricky to understand but very natural to use.
*
* For example, we may have a main design.html containing our main
* website presentation with some slots (menu, content, etc...) then
* we may define a member.html macro which use the design.html macro
* for the general layout, fill the menu slot and let caller templates
* fill the parent content slot without interfering.
*/
private function pushSlots(PHPTAL_Php_CodeWriter $codewriter)
{
if (!$this->phpelement->hasAttributeNS('http://xml.zope.org/namespaces/metal', 'define-macro')) {
$codewriter->pushCode('$ctx->pushSlots()');
}
}
/**
* generate code that pops macro slots
* (restore slots if not inherited macro)
*/
private function popSlots(PHPTAL_Php_CodeWriter $codewriter)
{
if (!$this->phpelement->hasAttributeNS('http://xml.zope.org/namespaces/metal', 'define-macro')) {
$codewriter->pushCode('$ctx->popSlots()');
}
}
/**
* recursively generates code for slots
*/
private function generateFillSlots(PHPTAL_Php_CodeWriter $codewriter, PHPTAL_Dom_Node $phpelement)
{
if (false == ($phpelement instanceof PHPTAL_Dom_Element)) {
return;
}
// if the tag contains one of the allowed attribute, we generate it
foreach (self::$ALLOWED_ATTRIBUTES as $qname => $uri) {
if ($phpelement->hasAttributeNS($uri, $qname)) {
$phpelement->generateCode($codewriter);
return;
}
}
foreach ($phpelement->childNodes as $child) {
$this->generateFillSlots($codewriter, $child);
}
}
}
|
