Элемент <xsl:output>

  • Статья

Задает параметры, используемые при сериализации результирующих деревьев.

<xsl:output
  method = "xml" | "html" | "text" | QName 
  version = nmtoken 
  encoding = string
  omit-xml-declaration = "yes" | "no"
  standalone = "yes" | "no"
  doctype-public = string 
  doctype-system = string 
  cdata-section-elements = QNames 
  indent = "yes" | "no"
  media-type = string 
  />

Атрибуты

  • метод
    Указывает общий метод, используемый для вывода дерева результатов. Если префикс отсутствует, атрибут задает метод, указанный в документе, который должен иметь одно из значений «xml», «html», «text» или квалифицированное имя (QName), не представляющее собой NCName. Если префикс присутствует, он расширяется и служит указанием на метод вывода.

    Значение по умолчанию для атрибута method выбирается следующим образом: Если выполняется любое из следующих условий, по умолчанию выбирается метод вывода «html»:

    • Корневой узел дерева результатов имеет дочерний элемент.

    • Расширенное имя первого дочернего элемента корневого узла (то есть элемента документа) дерева результатов имеет локальную часть «html» (в любом сочетании символов верхнего и нижнего регистра) и пустой URI-идентификатор пространства имен.

    • Любые текстовые узлы, предшествующие первому дочернему элементу корневого узла дерева результатов содержат только пробелы.

    В противном случае по умолчанию используется метод вывода «xml». Метод вывода по умолчанию используется, если элементы <xsl:output> отсутствуют, или ни один из элементов <xsl:output> не задает значения для атрибута method.

    Если выводится XHTML, более эффективно задать метод вывода «xml», чем «html».

  • version
    Задает версию 1.0 по отношению к методу вывода «xml»; это значение появляется в XML-декларации вывода как <?xml version="1.0"?>.

  • encoding
    Задает предпочитаемую кодировку символов, которую должен использовать синтаксический анализатор для кодировки последовательностей символов в виде последовательностей байтов. Значение атрибута обрабатывается без учета регистра; оно должно содержать только печатаемые символы ASCII и быть зарегистрированным набором символов или начинаться с x-.

  • omit-xml-declaration
    Указывает, должен ли обработчик XSLT выводить XML-декларацию; значение должно быть yes или no.

  • Автономный
    Указывает, должен ли обработчик XSLT выводить объявление автономности документа; значение должно быть yes или no.

  • doctype-public
    Задает общий идентификатор для использования в определении DTD.

  • doctype-system
    Задает системный идентификатор для использования в определении DTD.

  • cdata-section-elements
    Задает список квалифицированных имен Полные имена (XSLT) элементов, дочерние текстовые узлы которых нужно выводить с помощью разделов CDATA.

  • indent
    Задает дополнительные пробелы, которые будут добавляться при выводе дерева результатов; значение должно быть yes или no.

  • media-type
    Задает тип носителя (MIME-тип содержимого) данных, получающийся в результате вывода дерева результатов.

Сведения об элементе

Количество вхождений

Без ограничений

Родительские элементы

xsl:stylesheet, xsl:transform

Дочерние элементы

(Нет дочерних элементов)

Заметки

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

Примеры

Примеры работы элемента <xsl:output> приведены в следующих разделах.