xdoc Alt ←

Метод transform

XSL-преобразование.

^документ.transform[шаблон]
^документ.transform[шаблон][XSLT-параметры]

Метод осуществляет XSL-преобразование документа по шаблону. Возможно задание XSLT-параметров.

Шаблон — или путь_к_файлу_с_шаблоном, или xdoc-документ. Parser может считать XML из произвольного источника, см. раздел «Чтение XML из произвольного источника».

XSLT-параметры — хеш строк, доступных из шаблона через <xsl:param … />.

Parser (в виде модуля к Apache или IIS) кеширует результат компиляции файла_с_шаблоном во внутреннюю форму, повторная компиляция не производится, а скомпилированный шаблон берется из кеша. Вариант CGI также кеширует шаблон, но только на один запрос. Шаблон перекомпилируется при изменении даты файлов шаблона.

Пример

# входной XDOC-документ
$sourceDoc[^xdoc::load[article.xml]]

# преобразование XDOC-документа шаблоном article.xsl
$transformedDoc[^sourceDoc.transform[article.xsl]]

# выдача результата в HTML-виде
^transformedDoc.string[
	$.method[html]
]

Если шаблон не считывается с диска, а создается динамически, важным вопросом становится: «А откуда загрузятся <xsl:import href="some.xsl"/>?», следует обратить внимание на возможность задания базового пути: «Параметр создания нового документа: Базовый путь».