Blame view

mobile/source/ext/phptal/PHPTAL/Php/Attribute/METAL/UseMacro.php 4.09 KB
a1684257   Administrator   first commit
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
  <?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: UseMacro.php 678 2009-07-20 11:59:12Z kornel $
   * @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, '-', '_');
  
          // 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);
          }
      }
  }