Элемент <xsl:call-template>: применение именованных шаблонов

Элемент <xsl:call-template>: применение именованных шаблонов

У элемента <xsl:template> есть атрибут name, задающий имя шаблона. Предположим, у меня есть элемент буквального результата, состоящий из двух элементов <BR> и двух элементов <HR> HTML, при помощи которого я создаю в документах HTML вертикальный разделитель:

<BR/>

<HR/>

<BR/>

<HR/>

Тогда я могу создать шаблон с именем «separator» (разделитель), использующий этот элемент буквального результата:

<xsl:template name="separator">

 <BR/>

 <HR/>

 <BR/>

 <HR/>

</xsl:template>

Это именованный шаблон — для его создания нужно только присвоить имя атрибуту name элемента <xsl:template>.

Заметьте, что этот шаблон не установлен для выбора чего-то конкретного. Для активизации шаблона необходимо вызвать его явно. Для этого служит элемент <xsl:call-template>, обладающий только одним атрибутом:

• name (обязательный). Имя вызываемого шаблона, устанавливается в QName.

Следующий пример демонстрирует применение нашего шаблона «separator», для чего мне нужно было только вызвать его в соответствующих местах:

<?xml version="1.0"?>

<xsl:stylesheet version="1.1"

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

 <xsl:template match="/PLANETS">

  <HTML>

   <HEAD>

    <TITLE>

     The Planets Table </TITLE>

    </HEAD>

    <BODY>

     <H1>

      The Planets Table

     </Н1>

     <xsl:call-template name="separator"/>

     <TABLE BORDER="2">

      <TR>

       <TD>Name</TD>

       <TD>Mass</TD>

       <TD>Radius</TD>

       <TD>Day</TD>

      </TR>

      <xsl:apply-templates/>

     </TABLE>

     <xsl:call-template name="separator"/>

    </BODY>

   </HTML>

  </xsl:template>

  <xsl:template match="PLANET">

   <TR>

    <TD><xsl:value-of select="NAME"/></TD>

    <TD><xsl:apply-templates select="MASS"/></TD>

    <TD><xsl:apply-templates select="RADIUS"/></TD>

    <TD><xsl:apply-templates select="DAY"/></TD>

   </TR>

 </xsl:template>

 <xsl:template match="MASS">

  <xsl:value-of select="."/>

  <xsl:text> </xsl:text>

  <xsl:value-of select="@UNITS"/>

 </xsl:template>

 <xsl:template match="RADIUS">

  <xsl:value-of select="."/>

  <xsl:text> </xsl:text>

  <xsl:value-of select="@UNITS"/>

 </xsl:template>

 <xsl:template match="DAY">

  <xsl:value-of select="."/>

  <xsl:text> </xsl:text>

  <xsl:value-of select="@UNITS"/>

 </xsl:template>

 <xsl:template name="separator">

  <BR/>

  <HR/>

  <BR/>

  <HR/>

 </xsl:template>

</xsl:stylesheet>

Вот результат. Обратите внимание: элементы <BR> и <HR> были вставлены так, как требовалось:

<HTML>

 <HEAD>

  <TITLE>

   The Planets Table

  </TITLE>

 </HEAD>

 <BODY>

  <H1>

   The Planets Table

  </H1>

  <BR>

  <HR>

  <BR>

  <HR>

  <TABLE BORDER="2">

   <TR>

    <TD>Name</TD>

    <TD>Mass</TD>

    <TD>Radius</TD>

    <TD>Day</TD>

   </TR>

   <TR>

    <TD>Mercury</TD>

    <TD>.0553 (Earth = 1)</TD>

    <TD>1516 miles</TD>

    <TD>58.65 days</TD>

   </TR>

   <TR>

    <TD>Venus</TD>

    <TD>.815 (Earth = 1)</TD>

    <TD>3716 miles</TD>

    <TD>116.75 days</TD>

   </TR>

   <TR>

    <TD>Earth</TD>

    <TD>1 (Earth = 1)</TD>

    <TD>2107 miles</TD>

    <TD>1 days</TD>

   </TR>

  </TABLE>

  <BR>

  <HR>

  <BR>

  <HR>

 </BODY>

</HTML>

Результирующий документ показан на рис. 9.1.

Рис. 9.1. Вызов именованного шаблона

Таким образом, вы можете обращаться к элементу буквального результата по имени, легко помещая его в результирующий документ. Но это слишком статично — элемент буквального результата всегда один и тот же. Впрочем, как можно заметить, вызов именованного шаблона во многом похож на вызов подпрограммы в языке программирования. Так же, как вы передаете данные в подпрограмму, вы можете передать данные в именованные шаблоны при помощи параметров.