Книга: Технология XSLT

Функция system-property

Функция system-property

Синтаксис этой функции приведен ниже:

object system-property(string)

Функция system-property возвращает значение свойства, которое определяется ее строковым параметром. Аргумент этой функции должен представлять расширенное имя системного свойства. Если процессор не поддерживает свойство с таким именем, функция должна вернуть пустую строку.

Эта функция предназначена для получения информации об окружении, в котором производится преобразование. В стандарте языка указано, что все процессоры в обязательном порядке должны поддерживать следующие системные свойства:

? xsl:version — это свойство должно возвращать номер версии языка XSLT, которую поддерживает данный процессор.

? xsl:vendor — это свойство должно возвращать текстовую информацию о производителе используемого процессора.

? xsl:vendor-uri — это свойство должно возвращать URL производителя — как правило, xsl:vendor-uri — это адрес Web-сайта производителя процессора.

К сожалению, в первой версии языка XSLT процессоры обязаны поддерживать только эти свойства. Очень полезным, было бы, например, свойство, возвращающее имя преобразования или преобразовываемого файла. К сожалению, ничего подобного в стандарте не предусмотрено.

В качестве примера приведем небольшой шаблон, выводящий в виде комментария информацию о процессоре.

<xsl:template name="info">
 <xsl:comment>
  <xsl:text>&#xA; | XSLT Version: </xsl:text>
  <xsl:value-of
   select="format-number(system-property('xsl:version'), '0.0')"/>
  <xsl:text>&#xA; | XSLT Processor: </xsl:text>
  <xsl:value-of select="system-property('xsl:vendor')"/>
  <xsl:text>&#xA; | URL: </xsl:text>
  <xsl:value-of select="system-property('xsl:vendor-url')"/>
  <xsl:text>&#xA; +</xsl:text>
 </xsl:comment>
</xsl:template>

Процессор SAXON, написанный Майклом Кеем (Michael Kay), выводит следующий комментарий:

<!--
 | XSLT Version: 1.0
 | XSLT Processor: SAXON 6.0.2 from Michael Kay of ICL
 | URL: http://users.iclway.co.uk/mhkay/saxon/index.html
 +-->

Ожидается, что в будущих версиях XSLT набор системных свойств будет расширен. Кроме того, многие процессоры поддерживают дополнительные системные свойства, не оговоренные в спецификации.

Оглавление книги