- Веб-Шаблоны
- Шаблон интернет-магазина
- Шаблоны для CMS
- Facebook шаблоны
- Конструктор сайтов
formStructure.xml файл
Ноябрь 15, 2010
Структура файла fcContactFormStructure.xml описывает поля форм ы , их типы и свойства. Форма основана на данных из этого файла и поэтому не будет работать правильно, если этот файл содержит ошибки. Не рекомендуется редактировать этот файл, не понимая того, что вы делаете.
Структура этого файла должно совпадать с существующи ми файлами , которые уже были созданы в Flash и индексируются. Добавление нового пункта в этом файле не будет создавать новые поля в форме. Для этого необходимо добавить новые поля в Flash, а также, что это вставить ее в. FLA файл с Flash Authoring окружающей среды и создать новый. SWF файла из него.
Этот файл создается основе струкутрного языка XML и должен соответствовать всем требованиям этого языка ( http://www.w3.org/XML/ ). Поэтому мы настоятельно рекомендуем вам использовать XML редакторы (например Altova XMLSpy и др.) для работы с этим файлом. Любые ошибки, допущенные в этом файле мо гу т привести к неисправной работе контакт форм ы .
В целом структур а файла должн а выглядеть следующим образом:
<formItems>
<item/>
<item/>
<item/>
…
<item/>
</formItems>
Каждый из этих пунктов имеет обязательные и необязательные атрибуты.
Пример:
<item id=’1′ label=’First Name’ required=’true’ type=’text’>
id (обязательный атрибут) представляет собой уникальный номер пункта в форме. И не обязательно, чтобы все номера в форме были по порядку . Вполне возможно, что элемент с ID = 2 будет идти перв ым . Но это очень важно для них быть уникальным и , и количество элементов должно соответствовать самому высок о м у идентификатор у . То есть, если у вас есть 4 пункт а — идентификаторы должны быть от 1 до 4.
Label (обязательный атрибут) является имя формы, элемент, который используется для проверки сообщения об ошибках.
required (необязательный атрибут) занимает одно из двух значений « true » или « false » и определяет, если в поле ввода требуется или не на заполнив форму. По умолчанию требуется установлен неверно.
type (необязательный атрибут) является полем типа и может принимать следующие значения
« text » — текстовое поле;
« select » — выпадающий список;
« checkbox » — ( выбор нескольк их п ункт ов возможен);
« radiobutton » — (допускается выбор только одн ого пункт а и не более того);
Т ип поля должны соответствовать пункт у форм ы , который создается в Flash. То есть, если у вас есть выпадающий список (выбор) в Flash должен быть выбор, и больше ничего. По умолчанию тип имеет значение текста.
Кроме того, атрибуты элементов формы могут иметь узл ы , которые не являются обязательными и обеспечивают дополнительную функциональность для отображения контакт форм ы , ее валидации и подтверждении . Мы будем называть их свойства элементов. Свойства могут быть отнесены к различным элементам контакт формы ( text, select, checkbox, radiobutton ). Свойства определяются как дополнительные узлы. Например textToShow указывает, что текст следует показывать в текстово м поле, когда форма инициализ ирована . По умолчанию textToShow получил пустую строку в качестве значения. Следующий пример приведет к новой области с текстом «Сообщение:»
<item id=»5″ label=»Message» required=»true»>
<textToShow>Message:</textToShow>
</item>
Для предметов «текст» введите:
• textToShow — текст, который будет появляться в форме инициализации (для форм, которые не имеют этикетки Имя поля)
• validator — тип валидатор а :
о StringValidator
о EmailValidator
о NumberValidator
о DateValidator
При использовании валидатора , мо гу т быть использован ы дополнительные свойства, относящиеся к конкретн о м у валидатору .
StringValidator :
minChars — минимальное количество символов, которое допускается в этом поле
regExp — стандартное выражение, которому должн о совпадать значение поля. Он используется вместе с regExpFlags.
regExpFlags — постоянные вариант ы выражени й . Он используется только тогда, когда reqExp присутствует. Возможные варианты таковы:
g — глобальный, определяет, будет ли поиск соответствовать все м вариантам данного случая .
i — caseInsensitive. Если он присутствует , данный вариант не учитывается.
m — многоканальный
NumberValidator :
minValue — минимальное значение
MAXVALUE — максимальное значение
allowNegative — определяет, будет ли вам разрешено ввести отрицательное число
EmailValidator :
minLettersAfterLastPoint — минимальное количество символов, до последней точки
maxLettersAfterLastPoint — Максимальное количество символов до последней точки
minLettersBeforeAt — минимальное количество символов перед «@»
maxLettersBeforeAt-максимальное количество символов перед «@»
DateValidator :
mask — маска , которая будет подтверждать дат у . По умолчанию стоит формат мм / дд / год. Если мм гггг чч или не может быть найден , то по умолчанию используется маска.
minDateAllowed — минимальны е символы , что могут быть введены, должны соответствовать маске
maxDateAllowed — максимальн ые символы , которые могут быть введены, должны соответствовать маске
Например:
<item id=»3″ label=»Some number:» required=»true»>
<textToShow>Age:</textToShow>
<validator>NumberValidator</validator>
<minValue>5</minValue>
<maxValue>50</maxValue>
<allowNegative>false</allowNegative>
</item>
• restrict – символы , что допускаются для ввода
• maxChars — максимальное ограничение символов
• password – определяет заполнено ли поле пароля (символы заменяются звездочками)
Для вариантов типа « select «:
• firstItem — первый вопрос, который часто используется, например, «Выберите страну» в списк е стран
• dataProvider — поставщика данных. Он может быть определен непосредственно следующим образом:
<dataprovider>
<item>UK</item>
<item>USA</item>
<item>Canada</item>
</dataprovider>
или со ссылкой на. XML-файл с в ашей структурой. Там в только требования к структуре: все ее элементы должны быть завернуты в <item></item>
Например:
<?xml version=»1.0″ encoding=»utf-8″?>
<xmldata>
<item>UK</item>
<item>USA</item>
<item>Canada</item>
</xmldata>
поля такого типа могут быть связаны с помощью свойств атрибутов dataProvider: dependence и depth .
• dependence — пункт fcContactFormStructure.xml файл, который зависит от идентификатор а
• depth — глубина , где будут собраны данные из указанного . XML-файл а
П ростым примером здесь является следующее соотношение: марка автомобиля: модель :: д оступные цвета. Существуют различные бренды. Каждый бренд имеет свои собственные модели. Каждая модель имеет свои собственные цвета.
Для предметов «флажок» и «выпадающий» типа:
• выбрали — определяет, если элемент выбран изначально
Групповое свойство есть общ им для всех элементов. Это свойство имеет свои атрибуты: minRequired , maxRequired , разделителя. Он и определя ю т группу, которая относится к полю формы . Атрибуты группы заключаются в следующем:
• minRequired — требуемое минимальное количество полей, которые будут отобраны
• maxRequired — требуется максимальное количество полей, которые будут выбраны
• delimiter — строка, используемая для форматирования отправк и электронной почт ы и вставляется между значениями. Например, в случае флажк а используется часто запятая (‘,’).
• shouldBeEqual – может быть истинным или ложным, выставлено ложн ым по умолчанию. Если исттиноо , значения всех полей группы сравниваются, и если они не равны выдаст ошибк у.