5.3.27.2. Переключение между поддеревьями объектов форматирования
Для переключения между поддеревьями используются элементы fo:multi-switch, fo:multi-case и fo:multi-toggle. Структура результирующего дерева показана на рис. 5.3.13.
Элемент fo:multi-switch служит оболочкой для определения альтернативных поддеревьев объектов форматирования (каждое поддерево находится внутри элемента fo:multi-case) и управляет активируемым с помощью fo:multi-toggle переключением альтернатив. Содержимым этого элемента является один или несколько элементов fo:multi-case.
Для элемента может быть задан уникальный идентификатор в свойстве id.
Рис. 5.3.13. Структура результирующего дерева
Свойство auto-restore задает поведение переключателей в случае вложенных элементов fo:multi-switch. Значение "true" определяет, что если этот переключатель fo:multi-switch содержится в другом переключателе fo:multi-switch и этот fo:multi-switch изменяет активный fo:multi-case (скрывая fo:multi-switch), тогда этот fo:multi-switch должен восстанавливать этот начальный fo:multi-case, а значение "false" определяет, что этот fo:multi-switch не должен изменять свой fo:multi-case (это значение по умолчанию).
Элемент fo:multi-case используется как контейнер (внутри fo:multi-switch) каждого альтернативного поддерева объектов форматирования, среди которых родительский элемент fo:multi-switch выберет одно для показа и скроет остальные. Содержимое этого элемента либо пустое, либо одна или несколько символьных областей (#PCDATA), либо одна или несколько блоковых областей, либо одна или несколько внутристроковых областей.
Обязательное свойство name задает имя элемента (имя должно быть уникальным среди имеющихся родственных элементов fo:multi-case, т.е. в области видимости объекта fo:multi-switch, который их содержит).
Обязательное свойство case-title задает строку – описательное название для элемента fo:multi-case. Название может отображаться в меню для представления этого элемента, когда элемент fo:multi-toggle именует несколько элементов fo:multi-case как допустимые объекты назначения.
Для элемента может быть задан уникальный идентификатор в свойстве id.
Свойство starting-state задает начальное состояние видимости элемента: значение "show" – элемент является видимым (значение по умолчанию) или "hide" – элемент является невидимым.
Элемент fo:multi-toggle обычно используется для установки области, которая, после активации (например, реализованной как "clicked"), осуществляет переключение от одного элемента fo:multi-case к другому.
Содержимое этого элемента либо пустое, либо одна или несколько символьных областей (#PCDATA), либо одна или несколько блоковых областей, либо одна или несколько внутристроковых областей.
Для элемента может быть задан уникальный идентификатор в свойстве id.
Свойство switch-to определяет, на какой из элементов fo:multi-case будет переключать этот элемент. Это свойство может принимать одно из следующих значений:
"xsl-preceding"– активация переключателя должна в результате давать замещение текущего элементаfo:multi-caseего предшествующим родственником;
"xsl-following"– активация переключателя должна в результате давать замещение текущего элементаfo:multi-caseего последующим родственником;
"xsl-any"– активация переключателя должна дать пользователю возможность выбора другого родственника – элементаfo:multi-case(значение по умолчанию)
имя– значение свойстваcase-nameэлементаfo:multi-case;
список– списокимен, разделенных пробелами (пользователь может переключаться на любой из именованных объектов).