Что делает элемент «update» в XML макета Magento? - PullRequest
21 голосов
/ 05 октября 2011

Прямо сейчас я изучаю внутреннюю часть раздела администрирования Magento и наткнулся на этот кусок XML:

Файл: app/design/adminhtml/default/default/layout/catalog.xml, около 55

50            <block type="core/template" template="catalog/wysiwyg/js.phtml"/>
51        </reference>
52    </adminhtml_catalog_product_new>
53    
54    <adminhtml_catalog_product_edit>
55        <update handle="editor"/>
56        <reference name="content">
57            <block type="adminhtml/catalog_product_edit" name="product_edit"></block>
58        </reference>

Что делает тег <update />?

Ответы [ 2 ]

55 голосов
/ 05 октября 2011

<update> в основном использует другой дескриптор.

Предположим, у вас есть это:

<layout>
   <foo>
      <reference name="header">
          <block type="cms/block" name="some_block" as="someBlock">
              <action method="setBlockId"><block_id>some_block</block_id></action>
          </block>
      </reference>
      <reference name="left">
          <block type="cms/block" name="some_totally_different_block" as="someTotallyDifferentBlock">
              <action method="setBlockId"><block_id>some_totally_different_block</block_id></action>
          </block>
      </reference>
   </foo>
   <bar>
      <update handle="foo" /> 
      <reference name="header">
          <block type="cms/block" name="some_other_block" as="someOtherBlock">
              <action method="setBlockId"><block_id>some_other_block</block_id></action>
          </block>
      </reference>
   </bar>
</layout>

Полученный XML для bar будет:

<layout>
   <bar>
      <reference name="header">
          <!-- Start of part pulled in from foo -->
          <block type="cms/block" name="some_block" as="someBlock">
              <action method="setBlockId"><block_id>some_block</block_id></action>
          </block>
          <!-- End of part pulled in from foo -->
          <block type="cms/block" name="some_other_block" as="someOtherBlock">
              <action method="setBlockId"><block_id>some_other_block</block_id></action>
          </block>
      </reference>
      <!-- Start of part pulled in from foo -->
      <reference name="left">
          <block type="cms/block" name="some_totally_different_block" as="someTotallyDifferentBlock">
              <action method="setBlockId"><block_id>some_totally_different_block</block_id></action>
          </block>
      </reference>
      <!-- End of part pulled in from foo -->
   </bar>
</layout>

tl; dr: Дескриптор update по сути является «объединением этого макета с моим текущим макетом».

8 голосов
/ 05 октября 2011

Этот дескриптор используется для объединения существующих дескрипторов макета с вашим текущим макетом. В вашем примере <update handle="editor"/> добавит к <adminhtml_catalog_product_edit> следующее содержимое:

<editor>
            <reference name="head">
                <action method="setCanLoadExtJs"><flag>1</flag></action>
                <action method="addJs"><script>mage/adminhtml/variables.js</script></action>
                <action method="addJs"><script>mage/adminhtml/wysiwyg/widget.js</script></action>
                <action method="addJs"><script>lib/flex.js</script></action>
                <action method="addJs"><script>lib/FABridge.js</script></action>
                <action method="addJs"><script>mage/adminhtml/flexuploader.js</script></action>
                <action method="addJs"><script>mage/adminhtml/browser.js</script></action>
                <action method="addJs"><script>prototype/window.js</script></action>
                <action method="addItem"><type>js_css</type><name>prototype/windows/themes/default.css</name></action>
                <action method="addItem"><type>js_css</type><name>prototype/windows/themes/magento.css</name></action>
            </reference>
</editor>

(дескриптор «редактора» определен в app/design/adminhtml/default/default/layout/main.xml)

...