11.4 Элемент Template

<!ENTITY % navelmts "do | onevent"> 
<!ELEMENT template (%navelmts;)*> 
<!ATTLIST template
%cardev;
%coreattrs;
>

Элемент template объявляет шаблон для карт в деке. Связь событий, определенных в элементе template (например, do или onevent), применяется ко всем картам в деке. Определение связи событий в элементе template является эквивалентом для определения события в каждом элементе card. Элемент card может преодолеть поведение, определенное в элементе template. В частности:

• Элемент do, определенный в элементе template, может преодолеваться в индивидуальных картах, если оба элемента имеют такое же значение атрибута name. Смотрите раздел 9.6 для получения подробной информации.
• Связь встроенных событий, определенных в элементе template, может преодолеваться спецификацией связи события в элементе card. Смотрите раздел 9.6 для получения подробной информации.

Смотрите раздел 11.5.1 для определения встроенных событий на уровне карты (примитив cardev).

11.5 Элемент Card

Дека WML содержит коллекцию карт. Каждая карта может иметь разнообразное содержание. Взаимодействие пользователя с картой зависит от типа содержания, которое имеет карта, а также как содержание выводится устройством вывода.

11.5.1 Встроенные события карты

<!ENTITY % cardev
"onenterforward %HREF; #IMPLIED
onenterbackward %HREF; #IMPLIED
ontimer %HREF; #IMPLIED"
>

Следующие атрибуты доступны в элементах card и template.

Событие onenterforward происходит тогда, когда пользователь активирует устройство вывода осуществить навигацию в карте с использованием задачи go.

Событие onenterbackward происходит тогда, когда пользователь активирует устройство вывода осуществить навигацию в карте с использованием задачи prev.

Событие ontimer происходит тогда, когда завершается таймер - timer.

11.5.2 Элемент Card

<!ELEMENT card (onevent*, timer?, (do | p | pre)*)> 
<!ATTLIST card
title	%vdata;	#IMPLIED
newcontext	%boolean;	"false"
ordered	%boolean;	"true"
xml:lang	NMTOKEN	#IMPLIED %cardev;
%coreattrs;
>

Элемент card является контейнером для текста и элементов ввода, который достаточно гибок для разрешения презентации и разметки в широком разнообразии устройств, с широким разнообразием экранов и символов ввода. Элемент card указывает общую разметку и требует поля ввода, но не слишком ограничивает работу устройства вывода в областях разметки и ввода пользователя. Например, элемент card может представляться как одна страница на устройстве с большим экраном и как серия маленьких страниц на устройстве с маленьким экраном.

Элемент card может содержать разметку, поля ввода и элементов, определяющих структуру карты. Порядок элементов в карте важен, и он должен учитываться устройством вывода. Id элемента card может использоваться как анкер фрагмента. Смотрите раздел 5.2 для более подробной информации.

Атрибут title определяет информацию о карте. Атрибут title может выводиться устройством вывода различными способами (например, предлагаемое имя закладки, всплывающая подсказка и т.д.).

Этот атрибут указывает на то, что текущий контекст обозревателя должен повторно инициализировать вход на эту карту. Смотрите раздел 10.2 для получения подробной информации.

Этот атрибут определяет подсказку для устройства вывода об организации содержания card. Этот совет может использоваться для организации представления содержания или другого влияния на разметку карты.

• ordered="true" – карта организована как линейная последовательность элементов полей, например, набор вопросов или полей, которые естественно манипулируются пользователем в порядке, в котором они определены в группе. Этот стиль является самым лучшим из коротких форм, в которых поля не являются факультативными (например, посылка сообщения по электронной почте требует To: адрес, тему и сообщение, и они логически определяются в таком порядке).
  Ожидается, что в устройствах с маленьким экраном группы ordered могут представляться как последовательность экранов с экранным переходом между каждым полем или набором полей. Другие устройства вывода могут выбирать представление всех полей одновременно.
• ordered=" false" – карта является коллекцией элементов полей без естественного порядка. Это полезно для коллекций полей, содержащих факультативные или неорганизованные компоненты или простые данные записи, где пользователь обновляет индивидуальные поля ввода.

Ожидается, что в устройствах с маленьким экраном неорганизованные группы могут представляться с помощью иерархической или древовидной организации. В этих типах представления атрибут title каждого поля и набора полей может использоваться для определения имени, представленного пользователю на уровне суммирующей карты верхнего уровня. Устройство пользователя может организовать неорганизованную коллекцию элементов в неорганизованной манере.

Устройство вывода может интерпретировать организованный атрибут способом, соответствующим возможностям устройства (например, размер экрана или устройство ввода). Дополнительно, устройство вывода должно адаптировать правила интерфейса пользователя для манипулирования с редактированием элементов ввода способом, который наилучшим образом подходит для модели ввода устройства.

Например, устройства класса телефон, показывающие карту (card) с помощью ordered=" false" могут использовать функциональную клавишу или кнопку для выбора индивидуальных полей для редактирования или просмотра. Устройства класса персонального цифрового секретаря, или "карманного" компьютера, (PDA) может создавать функциональную клавишу по требованию или просто представлять все поля на экране для прямой манипуляции.

На устройстве с ограниченными возможностями экрана, часто нельзя вставить переключатели экрана или другие переходы пользовательского интерфейса между полями. В этом случае устройство вывода должно установить правильную границу между полями. Устройства вывода могут использовать следующую иерархию для выбора месторасположения перехода экрана:

• fieldset определяет логическую границу между полями.
• Поля (например, input) могут выводиться на экран индивидуально. В этом случае строка разметки (flow), непосредственно предшествующая полю, должна обрабатываться как объяснение поля и выводится на экран вместе с элементом input. Элемент table должен обрабатываться отлично от input и select. Устройство вывода должно вставлять обрыв строки (line break) перед элементом table, исключая случай, когда он является первым в разметке без пробела в карте. Устройство вывода должно вставлять обрыв строки (line break) после каждого элемента table, исключая случай, когда он является последним элементом в карте.

• xml:lang (смотрите раздел 8.8)
• id (смотрите раздел 8.9)
• class (смотрите раздел 8.9)
• onenterforward (смотрите раздел 11.5.1)
• onenterbackward (смотрите раздел 11.5.1)
• ontimer (смотрите раздел 11.5.1)

11.5.2.1 Элемент Card

Следующий пример – простой элемент card, вложенный в деку WML. Карта включает текст, который выводится на экран устройством вывода. Дополнительно, пример показывает использование простого элемента DO, определенный на уровне деки.

<wml>
<template>
<do type="accept" label="Exit">
<prev/> 
</ do>
</template> 
<card>
<p>
Hello World!
</p>
</card>
</wml>