system-property()¶
Функция system-property
возвращает значение свойства, которое определяется ее строковым параметром.
Аргумент этой функции должен представлять расширенное имя системного свойства. Если процессор не поддерживает свойство с таким именем, функция должна вернуть пустую строку.
Синтаксис¶
object system-property( string )
Описание и примеры¶
Эта функция предназначена для получения информации об окружении, в котором производится преобразование. В стандарте языка указано, что все процессоры в обязательном порядке должны поддерживать следующие системные свойства:
xsl:version
— это свойство должно возвращать номер версии языка XSLT, которую поддерживает данный процессор.xsl:vendor
— это свойство должно возвращать текстовую информацию о производителе используемого процессора.xsl:vendor-uri
— это свойство должно возвращать URL производителя — как правило,xsl:vendor-uri
— это адрес Web-сайта производителя процессора.
К сожалению, в первой версии языка XSLT процессоры обязаны поддерживать только эти свойства. Очень полезным, было бы, например, свойство, возвращающее имя преобразования или преобразовываемого файла. К сожалению, ничего подобного в стандарте не предусмотрено.
Пример¶
В качестве примера приведем небольшой шаблон, выводящий в виде комментария информацию о процессоре.
Листинг 8.72. Шаблон, выводящий системную информацию
<xsl:template name="info">
<xsl:comment>
<xsl:text>| XSLT Version:</xsl:text>
<xsl:value-of
select="format-number(system-property('xsl:version'), '0.0')"
/>
<xsl:text>| XSLT Processor:</xsl:text>
<xsl:value-of select="system-property('xsl:vendor')" />
<xsl:text>| URL:</xsl:text>
<xsl:value-of
select="system-property('xsl:vendor-url')"
/>
<xsl:text>+</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 набор системных свойств будет расширен. Кроме того, многие процессоры поддерживают дополнительные системные свойства, не оговоренные в спецификации.
Ссылки¶
- system-property() MDN (рус.)