| Пакет | mx.validators |
| Класс | public class DateValidator |
| Наследование | DateValidator  Validator EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
- месяц: от 1 до 12 (или 0 – 11 для объектов
Date); - день: от 1 до 31;
- год: число.
Определить дату в классе DateValidator можно двумя способами:
- Отдельной строкой с датой – для определения строки используются свойства
sourceиproperty. Строка может содержать цифры и символы форматирования, определенные свойствомallowedFormatChars, например символы "/\-. ". По умолчанию формат ввода даты в поле строки: MM/DD/YYYY, где ММ – месяц, DD – день и YYYY – год. СвойствоinputFormatможно использовать для определения другого формата. - Объект
Date. - Объект или несколько полей, содержащие день, месяц и год. Все следующие свойства используются для определения значений дня, месяца и года:
daySource,dayProperty,monthSource,monthProperty,yearSourceиyearProperty.
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <mx:DateValidator> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:DateValidator
allowedFormatChars="/\-. "
dayListener="Object specified by daySource"
dayProperty="No default"
daySource="No default"
formatError= "Configuration error: Incorrect formatting string."
inputFormat="MM/DD/YYYY"
invalidCharError="The date contains invalid characters."
monthListener="Object specified by monthSource"
monthProperty="No default"
monthSource="No default"
validateAsString="true|false"
wrongDayError="Enter a valid day for the month."
wrongLengthError="Type the date in the format inputFormat."
wrongMonthError="Enter a month between 1 and 12."
wrongYearError="Enter a year between 0 and 9999."
yearListener="Object specified by yearSource"
yearProperty="No default"
yearSource="No default"
/>
| Свойство | Определено | ||
|---|---|---|---|
| allowedFormatChars : String
Набор символов форматирования, допустимых для разделения значений месяца, дня и года. | DateValidator | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| dayListener : IValidatorListener
Компонент, прослушивающий результат проверки подчиненного поля дня. | DateValidator | ||
| dayProperty : String
Имя проверяемого свойства day. | DateValidator | ||
| daySource : Object
Объект, содержащий значение поля дня. | DateValidator | ||
| enabled : Boolean
Установка этого значения на false помешает выполнению проверки средством проверки. | Validator | |
| formatError : String
Сообщение об ошибке при обнаружении неверного формата свойства inputFormat. | DateValidator | ||
| inputFormat : String
Формат даты для проверки значения. | DateValidator | ||
| invalidCharError : String
Сообщение об ошибке при обнаружении в дате недопустимых символов. | DateValidator | ||
| listener : Object
Указывает прослушиватель проверки. | Validator | |
| monthListener : IValidatorListener
Компонент, прослушивающий результат проверки подчиненного поля месяца. | DateValidator | ||
| monthProperty : String
Имя проверяемого свойства month. | DateValidator | ||
| monthSource : Object
Объект, содержащий значение поля месяца. | DateValidator | ||
| property : String
Строка с именем свойства для объекта source, содержащего проверяемое значение. | Validator | |
| required : Boolean = true
Значение true указывает на то, что ошибка проверки вызвана отсутствующим или пустым значением. | Validator | |
| requiredFieldError : String
Сообщение об ошибке, если значение отсутствует, а свойство required имеет значение true. | Validator | |
| source : Object
Указывает объект, содержащий проверяемое свойство. | Validator | |
| trigger : IEventDispatcher
Указывает компонент, генерирующий запускающее средство проверки событие. | Validator | |
| triggerEvent : String
Указывает запускающее проверку событие. | Validator | |
| validateAsString : Object
Определяет способ проверки значения. | DateValidator | ||
| wrongDayError : String
Сообщение об ошибке при обнаружении недопустимого значения дня. | DateValidator | ||
| wrongLengthError : String
Сообщение об ошибке при несоответствии длины даты длине в свойстве inputFormat. | DateValidator | ||
| wrongMonthError : String
Сообщение об ошибке при обнаружении недопустимого значения месяца. | DateValidator | ||
| wrongYearError : String
Сообщение об ошибке при обнаружении недопустимого значения года. | DateValidator | ||
| yearListener : IValidatorListener
Компонент, прослушивающий результат проверки подчиненного поля года. | DateValidator | ||
| yearProperty : String
Имя проверяемого свойства year. | DateValidator | ||
| yearSource : Object
Объект, содержащий значение поля года. | DateValidator | ||
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | DateValidator | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
|
Посылает событие в поток событий. | EventDispatcher | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Вызывается автоматически компилятором MXML при создании класса Validator с помощью тега MXML. | Validator | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Выполняет проверку и дополнительно оповещает прослушиватели результата. | Validator | |
| [статические]
Вызывает все средства проверки в массиве validators. | Validator | |
[статические]
Удобный метод для вызова средства проверки в пользовательской функции проверки. | DateValidator | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Метод | Определено | ||
|---|---|---|---|
|
Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки. | Validator | |
[переопределить]
Переопределяет метод базового класса doValidation() для проверки даты. | DateValidator | ||
|
Возвращает проверяемый объект. | Validator | |
|
Возвращает ValidationResultEvent из массива результатов ошибки. | Validator | |
|
Возвращает true, если value не имеет значения null. | Validator | |
|
Отключает все прослушиватели для событий valid и invalid, передаваемых из средства проверки. | Validator | |
|
Этот метод вызывается при создании класса Validator и каждый раз при отправке ResourceManager события change для указания изменения локализованных ресурсов сходным образом. | Validator | |
allowedFormatChars | свойство |
allowedFormatChars:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Набор символов форматирования, допустимых для разделения значений месяца, дня и года.
Значением по умолчанию является "/\-. ".
Реализация
public function get allowedFormatChars():String public function set allowedFormatChars(value:String):voiddayListener | свойство |
dayListener:IValidatorListener| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Компонент, прослушивающий результат проверки подчиненного поля дня. Если он не указан, используется значение, указанное для свойства daySource.
Реализация
public function get dayListener():IValidatorListener public function set dayListener(value:IValidatorListener):voiddayProperty | свойство |
public var dayProperty:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Имя проверяемого свойства day. Это свойство является необязательным, но если определено свойство daySource, следует также указать это свойство.
daySource | свойство |
daySource:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Объект, содержащий значение поля дня. Если для этого свойства указано значение, следует также определить значение для свойства dayProperty. Не используйте это свойство, если определены свойства source и property.
Реализация
public function get daySource():Object public function set daySource(value:Object):voidformatError | свойство |
formatError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении неверного формата свойства inputFormat.
Значением по умолчанию является "Configuration error: Incorrect formatting string.".
Реализация
public function get formatError():String public function set formatError(value:String):voidinputFormat | свойство |
inputFormat:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Формат даты для проверки значения. ММ – месяц, DD – день и YYYY – год. Строка с учетом регистра.
Значением по умолчанию является "MM/DD/YYYY".
Реализация
public function get inputFormat():String public function set inputFormat(value:String):voidinvalidCharError | свойство |
invalidCharError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении в дате недопустимых символов.
Значением по умолчанию является "Invalid characters in your date.".
Реализация
public function get invalidCharError():String public function set invalidCharError(value:String):voidmonthListener | свойство |
monthListener:IValidatorListener| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Компонент, прослушивающий результат проверки подчиненного поля месяца. Если он не указан, используется значение, указанное для свойства monthSource.
Реализация
public function get monthListener():IValidatorListener public function set monthListener(value:IValidatorListener):voidmonthProperty | свойство |
public var monthProperty:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Имя проверяемого свойства month. Это свойство является необязательным, но если определено свойство monthSource, следует также указать это свойство.
monthSource | свойство |
monthSource:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Объект, содержащий значение поля месяца. Если для этого свойства указано значение, следует также определить значение для свойства monthProperty. Не используйте это свойство, если определены свойства source и property.
Реализация
public function get monthSource():Object public function set monthSource(value:Object):voidvalidateAsString | свойство |
validateAsString:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет способ проверки значения. Если установлено true, средство проверки анализирует значение как строку, если только значение не имеет свойства month, day или year. Если значение равно false, средство проверки анализирует значение как объект Date.
Значением по умолчанию является true.
Реализация
public function get validateAsString():Object public function set validateAsString(value:Object):voidwrongDayError | свойство |
wrongDayError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении недопустимого значения дня.
Значением по умолчанию является "Enter a valid day for the month.".
Реализация
public function get wrongDayError():String public function set wrongDayError(value:String):voidwrongLengthError | свойство |
wrongLengthError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при несоответствии длины даты длине в свойстве inputFormat.
Значением по умолчанию является "Type the date in the format inputFormat.".
Реализация
public function get wrongLengthError():String public function set wrongLengthError(value:String):voidwrongMonthError | свойство |
wrongMonthError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении недопустимого значения месяца.
Значением по умолчанию является "Enter a month between 1 and 12.".
Реализация
public function get wrongMonthError():String public function set wrongMonthError(value:String):voidwrongYearError | свойство |
wrongYearError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении недопустимого значения года.
Значением по умолчанию является "Enter a year between 0 and 9999.".
Реализация
public function get wrongYearError():String public function set wrongYearError(value:String):voidyearListener | свойство |
yearListener:IValidatorListener| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Компонент, прослушивающий результат проверки подчиненного поля года. Если он не определен, используется значение, указанное для свойства yearSource.
Реализация
public function get yearListener():IValidatorListener public function set yearListener(value:IValidatorListener):voidyearProperty | свойство |
public var yearProperty:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Имя проверяемого свойства year. Это свойство является необязательным, но если определено свойство yearSource, следует также указать это свойство.
yearSource | свойство |
yearSource:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Объект, содержащий значение поля года. Если для этого свойства определено значение, следует также указать значение для свойства yearProperty. Не используйте это свойство, если определены свойства source и property.
Реализация
public function get yearSource():Object public function set yearSource(value:Object):voidDateValidator | () | Конструктор |
public function DateValidator()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
doValidation | () | метод |
override protected function doValidation(value:Object):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Переопределяет метод базового класса doValidation() для проверки даты.
Этот метод не вызывается напрямую; Flex вызывает его как часть выполнения проверки. Этот метод необходимо реализовать при создании пользовательского класса Validator.
Параметры
value:Object — Проверяемая строка или объект.
|
Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.
|
validateDate | () | метод |
public static function validateDate(validator:DateValidator, value:Object, baseField:String):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удобный метод для вызова средства проверки в пользовательской функции проверки. Каждое стандартное средство проверки Flex имеет подобный удобный метод.
Параметры
validator:DateValidator — Экземпляр DateValidator.
| |
value:Object — Проверяемое поле.
| |
baseField:String — Текстовое представление подчиненного поля определяется в параметре value. Например, если параметр value имеет значение value.date, то baseField имеет значение date.
|
Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.
|
Связанные элементы API
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the DateValidator. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<fx:Script>
import mx.controls.Alert;
</fx:Script>
<fx:Declarations>
<fx:Model id="CheckModel">
<dateInfo>
<DOB>{dob.text}</DOB>
</dateInfo>
</fx:Model>
<mx:DateValidator source="{dob}" property="text" allowedFormatChars="/"
trigger="{myButton}" triggerEvent="click"
valid="Alert.show('Validation Succeeded!');"/>
</fx:Declarations>
<s:Panel title="DateValidator Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter date of birth (mm/dd/yyyy): ">
<s:TextInput id="dob" width="100%"/>
</mx:FormItem>
<mx:FormItem >
<s:Button id="myButton" label="Validate" />
</mx:FormItem>
</mx:Form>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 11:34 AM Z