Технология XSLT - читать бесплатно онлайн полную версию книги автора Алексей Н. Валиков (Приложение 2 Краткий справочник элементов и атрибутов XSLT) #15

Приложение 2 Краткий справочник элементов и атрибутов XSLT

Обозначения

Ниже перечислены обозначения, используемые в данной книге.

□

attribute

Обязательный атрибут.

□

attribute

Необязательный атрибут.

□

attribute="строка"

Атрибут со строковым параметром.

□

attribute="{строка}"

Атрибут со строковым параметром, значение которого является шаблоном значения атрибута.

□

attribute="yes" | "no"

Атрибут с вариантами значений.

□

attribute={ "yes" | "no" }

Атрибут с вариантами значений, которые могут быть заданы шаблонами значений атрибутов.

□

Содержимым элемента является шаблон.

□

Элемент содержит последовательность из нуля или более элементов

xsl:import

□

Элемент содержит последовательность из одного или более элементов

xsl:when

□

Элемент содержит элемент

xsl:otherwise

, который может быть пропущен.

Элементы

В табл. П2.1 приведены описания основных элементов XSLT.

Таблица П2.1. Описание основных элементов XSLT

Элемент	Описание
	Инструкция. Применяет шаблонные правила, которые содержатся в импортированных преобразованиях
	Инструкция. Применяет шаблонные правила к множеству узлов, возвращаемому выражением, записанным в атрибуте `select` . • `select` — содержит выражение, возвращающее множество узлов для обработки; • `mode` — указывает режим, в котором должны применяться шаблоны
`name="{имя}"`	Инструкция. Создает в выходящем документе узел атрибута. • `name` — определяет имя атрибута; • `namespace` — URI пространства имен создаваемого атрибута
`namespace="{пространство имен}">`
`name="имя" use-attribute-sets="имена">`	Элемент верхнего уровня. Определяет именованный набор атрибутов. • `name` — содержит имя набора атрибутов; • `use-attribute-sets` — перечисляет через пробелы имена наборов атрибутов, которые следует включить в определяемый набор
`name="имя">`	Инструкция. Вызов именованного шаблона. • `name` — имя вызываемого шаблона
	Инструкция. Выполняет содержимое одного из субэлементов в зависимости от условий
	Инструкция. Создает в выходящем документе узел комментария
	Инструкция. Создает в выходящем документе копию текущего узла. Копии дочерних узлов не создаются. • `use-attribute-sets` — перечисляет именованные наборы атрибутов, которые следует добавить в создаваемый узел
`select="выражение"/>`	Инструкция. Копирует в выходящий документ результат вычисления выражения. • `select` — содержит выражение, результат которого нужно скопировать
	Элемент верхнего уровня. Определяет именованный набор параметров для формата числа. • `name` — имя. Если `name` отсутствует, формат числа определяется по умолчанию; • `decimal-separator` — символ, разделяющий целую и дробную часть; • `grouping-separator` — символ, разделяющий группы цифр целой части числа; • `infinity` — строка, соответствующая бесконечности; • `minus-sign` — символ отрицания; • `NaN` — строка, соответствующая нечислу; • `percent` — символ процента; • `per-mille` — символ промилле; • `zero-digit` — символ нуля; • `digit` — символ, помечающий позицию необязательной цифры; • `pattern-separator` — символ, разделяющий положительный и отрицательный образцы форматирования
`name="{имя}" namespace="{пространство имен}" use-attribute-sets="имена">`	Инструкция. Создает в выходящем документе элемент. • `name` — имя элемента; • `namespace` — URI пространства имен создаваемого элемента; • `use-attribute-sets` — перечисляет имена наборов атрибутов, которые надо включить в создаваемый элемент
	Инструкция. Выполняется при невозможности выполнить родительскую инструкцию
`select="выражение">`	Инструкция. Выполняет содержащийся шаблон для каждого из узлов множества. • `select` — содержит выражение, возвращающее перебираемое множество узлов
`test="выражение" >`	Инструкция. Выполняет или не выполняет дочерний шаблон в зависимости от заданного условия. • `test` — содержит выражение проверяемого условия
`href="URI"/>`	Элемент верхнего уровня. Импортирует указанный шаблон. • `href` — URI импортируемого шаблона
`href="URI"/>`	Элемент верхнего уровня. Включает указанный шаблон. • `href` — URI включаемого шаблона
`name="имя" match="паттерн" use="выражение"/ >`	Элемент верхнего уровня. Определяет именованный ключ. • `name` — имя ключа; • `match` — выбирает узлы, для которых будут определяться значения ключа; • use — выражение, значение которого будет значением ключа для каждого из узлов
	Инструкция. Указывает процессору на то, что нужно вывести сообщение. • terminate — определяет, следует ли прервать обработку после вывода сообщения или нет
`stylesheet-prefix="префикс" \| "#default" result-prefix="префикс" \| "#default"/>`	Элемент верхнего уровня. Определяет псевдоним для префикса. • `stylesheet-prefix` — префикс в преобразовании; • `result-prefix` — префикс в результирующем документе
	Инструкция. Выводит номер в соответствии с заданными критериями. • `level` — на каких уровнях нумеровать узлы; • `count` — какие узлы учитывать при нумерации; • `from` — в какой части документа нумеровать узлы; • `value` — выражение, вычисляющее номер. • `format` — форматирующая строка номера; • `lang` — язык для алфавитных последовательностей; • `letter-value` — алфавитная или традиционная нумерация; • `grouping-separator` — разделяющий символ групп цифр номера; • `grouping-size` — количество цифр в группах цифр номера
	Субэлемент элемента `xsl:choose` . Выполняется в элементе `xsl:choose` , если ни одно из других условий не верно.
`префикс:имя" version="токен" encodings="строка" omit-xml-declaration="yes" \| "no" standalone="yes" \| "no" doctype-public="строка" doctype-system="строка" cdata-section-elements="имена" indent="yes" \| "no" media-type="строка"/>`	Элемент верхнего уровня. Определяет параметры вывода результирующего документа. • `method` — метод сериализации; • `version` — версия языка сериализации; • `encoding` — кодировка выходящего документа; • `omit-xml-declaration` — опустить декларацию XML; • `standalone` — самостоятельный или несамостоятельный документ; • `doctype-public` — публичный идентификатор типа документа; • `doctype-system` — системный идентификатор типа документа; • `cdata-section-elements` — элементы, содержимое которых следует выводить как секции CDATA; • `indent` — индентация (вывод отступов); • `media-type` — медиа-тип
`name="имя" select="выражение">`	Инструкция, элемент верхнего уровня. Определяет параметр преобразования или шаблонного правила. • `name` — имя параметра; • `select` — выражение, задающее значение параметра
`elements="токены"/>`	Элемент верхнего уровня. Определяет элементы входящего документа, в которых следует сохранять текстовые узлы, содержащие только пробельные символы. • `elements` — перечисляет элементы, в которых пробельные символы должны быть сохранены
`name="{имя}">`	Инструкция. Создает узел инструкции по обработке. • `name` — определяет имя целевого приложения создаваемой инструкции
`префикс:имя" } order={ "ascending" \| "descending" } case-order={ "upper-first" \| "lower-first"}/>`	Субэлемент элементов `xsl:apply-templates` и xsl `:for-each` . • `select` — выражения для сортировки; • `lang` — язык сортировки; • `data-type` — тип данных сортировки; • `order` — порядок сортировки; • `case-order` — упорядоченность строчных и прописных букв
`elements="токены"/>`	Элемент верхнего уровня. Определяет элементы входящего документа, в которых следует удалять текстовые узлы, содержащие только пробельные символы. • `elements` — перечисляет элементы, в которых пробельные символы должны быть удалены
`version="число">`	Корневой элемент преобразования. • `id` — идентификатор преобразования; • `extension-element-prefixes` — префиксы элементов расширения; • `exclude-result-prefixes` — префиксы, не включаемые в выходящий документ; • `version` — версия языка XSLT
	Элемент верхнего уровня. Определяет шаблонное правило. • `match` — содержит паттерн, которому должны удовлетворять узлы, обрабатываемые данным шаблоном; • `name` — имя шаблона; • `priority` — приоритет шаблона; • `mode` — режим шаблона
	Инструкция. Создает в выходящем документе текстовый узел. Пробельные символы, находящиеся внутри `xsl:text` , не удаляются. • `disable-output-escaping` — определяет, должны ли в выходящем документе особые символы этого текстового узла заменяться на сущности
`version="число">`	Корневой документ преобразования. Псевдоним элемента `xsl:stylesheet`
`select="выражение" disable-output-escaping="yes" \| "no"/>`	Инструкция. Создает в выходящем документе текстовый узел, содержащий результат вычисления выражения, приведенный к строке. • `select` — содержит вычисляемое выражение; • `disable-output-escaping` — определяет, должны ли в выходящем документе особые символы этого текстового узла заменяться на сущности
`name="имя" select="выражение" >`	Инструкция, элемент верхнего уровня. Создает глобальную или локальную переменную. Значение переменной не может быть изменено. • `name` — задает имя определяемой переменной; • `select` — задает значение определяемой переменной
`test="выражение">`	Субэлемент элемента `xsl:choose` . Выполняется один из вариантов в блоке `xsl:choose` в зависимости от условия. • `test` — задает выражение логического условия
`name="имя" select="выражение">`	Субэлемент элементов `xsl:apply- templates` , `xsl:call-template` . Задает значение одного параметра при вызове параметризованного шаблона. • `name` — имя параметра; • `select` — выражение, значение которого должно быть передано как параметр. В случае, если атрибут `select` не определен, значением передаваемого параметра является дерево, полученное в результате выполнения содержимого `xsl:with-param` . Если элемент при этом пуст, значением параметра является пустая строка

Атрибуты

Сведения об атрибутах XSLT представлены в табл. П2.2.

Таблица П2.2. Атрибуты XSLT

Атрибут	Назначение
`xsl:version`	Указывает версию языка в случае использования упрощенного синтаксиса записи преобразований
`xsl:exclude-result-prefixes`	Перечисляет префиксы пространств имен, которые должны быть исключены в данном элементе
`xsl:extension-elements-prefixes`	Перечисляет префиксы пространств имен, которые используются в элементах расширения
`xsl:use-attribute-sets`	Перечисляет названия именованных наборов атрибутов, которые следует включить в данный элемент на выходе