Учебное пособие (1075724), страница 27
Текст из файла (страница 27)
Например, если на элемент данных наложено ограничение«только для чтения», то соответствующее поле ввода не позволяет вводитьданные.В следующей таблице приведены наиболее часто используемые атрибутыэлемента xforms:bind.257Таблица 5.1. Атрибуты элемента xforms:bind.АтрибутЗначенииеnodeset="XPath-выражение, задающееПривязка элемента xforms:bind кссылку на элемент данных"элементу данныхtype="тип данных"Задание ограничения на тип данныхreadonly="XPath-выражение,Элемент данных доступен только длявозвращающее логическое значение"чтенияrequired="XPath-выражение,Элемент данных не может быть пустым,возвращающее логическое значение"то есть в соответствующий полюэлемент управления должны бытьвведены данныеrelevant="XPath-выражение,Соответствующий элемент управлениявозвращающее логическое значение"отображается для ввода данных (еслизначение ложно, то не отображается)calculate="XPath-выражение дляИспользуется для созданиявычисления значения элемента"вычисляемых полей.
Значение XPathвыражения вычисляется и сохраняетсякак данные XML-элемента. Часто этотатрибут используется вместе сатрибутом readonly.constraint="XPath-выражение,XML-элемент содержит правильныевозвращающее логическое значение"данные, если выражение истинно258В следующем примере используются различные типы ограничений.Пример 5.2. Файл «binds.xhtml».<?xml version="1.0" encoding="UTF-8"?><html xmlns="http://www.w3.org/1999/xhtml"xmlns:xforms="http://www.w3.org/2002/xforms"xmlns:ev="http://www.w3.org/2001/xml-events"xmlns:xsd="http://www.w3.org/2001/XMLSchema"><head><title>Пример элемента bind</title><!-- Пустой префикс пространства имен обязателен для корневогоэлемента xforms:instance --><xforms:model><!-- Создание нового типа данных, который используется припроверке --><xsd:schema><xsd:simpleType name="NewType"><xsd:restriction base="xsd:string"><xsd:enumeration value='abc'/><xsd:enumeration value='123'/></xsd:restriction></xsd:simpleType></xsd:schema><xforms:instance><example xmlns=""><flag>1</flag><bool>true</bool><date/><newtype/><readonlytext/><requiredtext/><reltext/><number1>200</number1>259<number2>100</number2><number_percent/><number_constraint>150</number_constraint></example></xforms:instance><!-- Ограничения на тип данных (стандартный или созданный с помощьюXML-схемы) --><xforms:bind nodeset="date" type="xforms:date"/><xforms:bind nodeset="newtype" type="NewType"/><!-- required="true()" означает, что поле обязательно для ввода --><xforms:bind nodeset="requiredtext" required="true()"/><!-- readonly="/example/flag!=1" означает, что поле недоступно дляввода данных (доступно только для чтения) если элемент flag(вложенный в элемент example) не равен 1 --><xforms:bind nodeset="readonlytext" readonly="/example/flag!=1"/><!-- relevant="/example/flag=1" означает, что поле отображается вформе если элемент flag (вложенный в элемент example) равен 1 --><xforms:bind nodeset="reltext" relevant="/example/flag=1"/><xforms:bind nodeset="number1" type="xforms:float"/><xforms:bind nodeset="number2" type="xforms:float"/><xforms:bind nodeset="number_percent" readonly="true()"type="xforms:float" relevant="(/example/number1 > 0) and(/example/number2 > 0)" calculate="round(((/example/number2) div(/example/number1))*100)"/>Элемент "number_percent" доступен только для чтения (readonly="true()").Атрибут relevant="(/example/number1 > 0) and (/example/number2 > 0)"означает, что поле отображается, только если элементы example/number1 иexample/number2 больше нуля.260Атрибут calculate="round(((/example/number2) div (/example/number1))*100)"вычисляет процентное значение.Значение автоматически пересчитывается при изменении зависимых XMLэлементов (в нашем случае number1 и number2).Вычисленное значение сохраняется в элемент "number_percent".<xforms:bind nodeset="number_constraint" type="xforms:float"constraint="(.
<= /example/number1) and (. >=/example/number2)" />Атрибутconstraint="(.<=/example/number1)and(.>=/example/number2)" означает, что поле заполнено правильно, если значение XPathвыражения в атрибуте constraint истинно.В нашем случае значение элемента, для которого задается ограничение"number_constraint" (.), должно быть меньше или равно элементу example/number1(. <= /example/number1) и должно быть больше или равно элементуexample/number2 (.
>= /example/number2).<!-- submission указывает, куда необходимо отправить форму --><xforms:submission action="" method="post" id="submit_id"includenamespaceprefixes=""/></xforms:model></head><body><xforms:group><xforms:input ref="date"><xforms:label>Введите дату:</xforms:label></xforms:input><xforms:input ref="newtype"><xforms:label>Введите 'abc' или '123':</xforms:label>261<xforms:message ev:event="xforms-valid">Введено правильноезначение</xforms:message><xforms:message ev:event="xforms-invalid">ВведеноНЕправильное значение</xforms:message></xforms:input><xforms:input ref="requiredtext"><xforms:label>Это поле обязательно для ввода:</xforms:label></xforms:input><xforms:input ref="readonlytext"><xforms:label>Это поле доступно для ввода данных толькокогда флаг установлен в 1:</xforms:label></xforms:input><xforms:input ref="reltext"><xforms:label>Это поле отображается для ввода данных толькокогда флаг установлен в 1:</xforms:label></xforms:input><xforms:trigger>Элемент «xforms:trigger» создает кнопку.<xforms:label>Установить флаг</xforms:label><xforms:setvalue ref="flag"ev:event="DOMActivate">1</xforms:setvalue>Элемент «xforms:setvalue» в данном случае является обработчиком события.Атрибут ev:event="DOMActivate" означает, что элемент xforms:setvalue долженреагироватьна«стандартное»событиеэлемента«xforms:trigger»,для«xforms:trigger» таким стандартным событием является нажатие кнопки.Элемент «xforms:setvalue» устанавливает значение элемента данных flag в 1.</xforms:trigger><xforms:trigger><xforms:label>Сбросить флаг</xforms:label>262<xforms:setvalue ref="flag"ev:event="DOMActivate">0</xforms:setvalue></xforms:trigger><xforms:output value="concat('Значение флага: ', flag)"/><xforms:input ref="/example/number1"><xforms:label>Число 1:</xforms:label></xforms:input><xforms:input ref="/example/number2"><xforms:label>Число 2:</xforms:label></xforms:input><xforms:input ref="/example/number_percent"><xforms:label>Число 2 составляет от числа 1процентов:</xforms:label></xforms:input><xforms:input ref="/example/number_constraint"><xforms:label>Введите число в диапазоне от число 1 до число2:</xforms:label><xforms:message ev:event="xforms-valid">Введено правильноезначение в диапазоне от число 1 до число 2</xforms:message><xforms:message ev:event="xforms-invalid">ВведеноНЕправильное значение в диапазоне от число 1 до число2</xforms:message></xforms:input><!-- Кнопка отправки формы.
Атрибут submission ссылается наэлемент xforms:submission в модели --><xforms:submit submission="submit_id"><xforms:label>Отправка формы</xforms:label></xforms:submit></xforms:group>263</body></html>Результат выполнения примера:Рис. 5.7. Результат выполнения примера 5.2. Файл «binds.xhtml».5.6.5 Использование нескольких моделей и инстансовВ предыдущих примерах использовались одна модель данных и одининстанс данных в модели.Однако, в XForms возможно использование нескольких моделей данных инескольких инстансов в каждой модели.В случае использования нескольких моделей данных в элементах управленияформы необходимо вместе с атрибутом «ref» использовать атрибут «model=idмодели» для ссылки на модель.264Если вместо атрибута «ref» используется атрибут «bind=id элементаxforms:bind», то ссылку на модель использовать не нужно, так как ссылка на idэлемента xforms:bind уникальна в рамках документа и автоматически определяетмодель данных.По умолчанию ссылки на данные соответствуют первому инстансу в модели.Если модель содержит несколько инстансов, то у этих инстансов необходимозадавать атрибут «id», и в XPath-выражениях для ссылки на эти инстансыиспользовать функцию «instance('id инстанса')».Для доступа к элементам данных можно использовать XPath-выражение вида«instance('id инстанса')//элемент данных».
Такие ссылки на XML-данныенеобходимо использовать и в элементах управления формы (атрибут «ref»), и вэлементах xforms:bind (атрибут «nodeset»).В следующем примере показано, как в случае использования несколькихмоделей и инстансов может осуществляться привязка данных.Пример 5.2. Файл «models.xhtml».<?xml version="1.0" encoding="UTF-8"?><html xmlns="http://www.w3.org/1999/xhtml"xmlns:xforms="http://www.w3.org/2002/xforms"xmlns:ev="http://www.w3.org/2001/xml-events" ><head><title>Пример использования нескольких моделей</title><!-- Пустой префикс пространства имен обязателен для корневогоэлемента xforms:instance --><xforms:model id="model1"><xforms:instance><example xmlns=""><text/></example></xforms:instance><xforms:instance id="instance_2">265<example xmlns=""><bool/></example></xforms:instance><!-- Элементы bind указывают тип данных --><!-- Тип данных указывается не для элемента управления, а дляэлемента данных в модели --><xforms:bind nodeset="instance('instance_2')//bool"type="xforms:boolean"/><!-- submission указывает куда необходимо отправить форму --><xforms:submission action="" method="post" id="submit_id1"includenamespaceprefixes=""/></xforms:model><xforms:model id="model2"><xforms:instance><example xmlns=""><date/><datetime/></example></xforms:instance><!-- Элементы bind указывают тип данных --><!-- Тип данных указывается не для элемента управления, а дляэлемента данных в модели --><xforms:bind nodeset="date" type="xforms:date"/><xforms:bind id="id_datetime" nodeset="datetime"type="xforms:dateTime"/><!-- submission указывает куда необходимо отправить форму --><xforms:submission action="" method="post" id="submit_id2"includenamespaceprefixes=""/></xforms:model>266</head><body><xforms:group><!-- Если в форме задано несколько моделей, то кроме элементаref должен использоваться атрибут model для ссылки на модель --><xforms:input ref="text" model="model1"><xforms:label>Введите текст:</xforms:label></xforms:input><xforms:input ref="instance('instance_2')//bool"model="model1"><xforms:label>Введите логическое значение:</xforms:label></xforms:input><xforms:submit submission="submit_id1"><xforms:label>Отправка формы 1</xforms:label></xforms:submit><xforms:input ref="date" model="model2"><xforms:label>Введите дату:</xforms:label></xforms:input><xforms:input bind="id_datetime"><xforms:label>Введите дату и время:</xforms:label></xforms:input><xforms:submit submission="submit_id2"><xforms:label>Отправка формы 2</xforms:label></xforms:submit></xforms:group></body></html>267Результат выполнения примера:Рис.















