| Пакет | mx.validators |
| Класс | public class EmailValidator |
| Наследование | EmailValidator  Validator EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Можно использовать имена IP-домена, если они заключены в квадратные скобки; например, myname@[206.132.22.1]. Можно использовать отдельные IP-номера от 0 до 255.
Синтаксис MXML
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <mx:EmailValidator> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:EmailValidator
invalidCharError="Your e-mail address contains invalid characters."
invalidDomainError= "The domain in your e-mail address is incorrectly formatted."
invalidIPDomainError="The IP domain in your e-mail address is incorrectly formatted."
invalidPeriodsInDomainError="The domain in your e-mail address has consecutive periods."
missingAtSignError="An at sign (&64;) is missing in your e-mail address."
missingPeriodInDomainError="The domain in your e-mail address is missing a period."
missingUsernameError="The username in your e-mail address is missing."
tooManyAtSignsError="Your e-mail address contains too many &64; characters."
/>
Общедоступные свойства
| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| enabled : Boolean
Установка этого значения на false помешает выполнению проверки средством проверки. | Validator | |
| invalidCharError : String
Сообщение об ошибке при обнаружении недопустимых символов в адресе электронного письма. | EmailValidator | ||
| invalidDomainError : String
Сообщение об ошибке при обнаружении суффикса (домена верхнего уровня) длиной не из 2, 3, 4 или 6 символов. | EmailValidator | ||
| invalidIPDomainError : String
Сообщение об ошибке при обнаружении недопустимого IP-домена. | EmailValidator | ||
| invalidPeriodsInDomainError : String
Сообщение об ошибке при наличии в домене многоточий. | EmailValidator | ||
| listener : Object
Указывает прослушиватель проверки. | Validator | |
| missingAtSignError : String
Сообщение об ошибке в случае отсутствия в адресе электронной почты знака «@». | EmailValidator | ||
| missingPeriodInDomainError : String
Сообщение об ошибке при отсутствии в домене точки. | EmailValidator | ||
| missingUsernameError : String
Сообщение об ошибке при отсутствии имени пользователя. | EmailValidator | ||
| property : String
Строка с именем свойства для объекта source, содержащего проверяемое значение. | Validator | |
| required : Boolean = true
Значение true указывает на то, что ошибка проверки вызвана отсутствующим или пустым значением. | Validator | |
| requiredFieldError : String
Сообщение об ошибке, если значение отсутствует, а свойство required имеет значение true. | Validator | |
| source : Object
Указывает объект, содержащий проверяемое свойство. | Validator | |
| tooManyAtSignsError : String
Сообщение об ошибке при наличии нескольких знаков «@» в адресе электронного письма. | EmailValidator | ||
| trigger : IEventDispatcher
Указывает компонент, генерирующий запускающее средство проверки событие. | Validator | |
| triggerEvent : String
Указывает запускающее проверку событие. | Validator | |
Защищенные свойства
Общедоступные методы
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | EmailValidator | ||
| 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 | |
[статические]
Удобный метод для вызова средства проверки в пользовательской функции проверки. | EmailValidator | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
Защищенные методы
| Метод | Определено | ||
|---|---|---|---|
|
Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки. | Validator | |
[переопределить]
Переопределение метода базового класса doValidation() для проверки адреса электронного письма. | EmailValidator | ||
|
Возвращает проверяемый объект. | Validator | |
|
Возвращает ValidationResultEvent из массива результатов ошибки. | Validator | |
|
Возвращает true, если value не имеет значения null. | Validator | |
|
Отключает все прослушиватели для событий valid и invalid, передаваемых из средства проверки. | Validator | |
|
Этот метод вызывается при создании класса Validator и каждый раз при отправке ResourceManager события change для указания изменения локализованных ресурсов сходным образом. | Validator | |
События
Защищенные константы
Сведения о свойстве
invalidCharError | свойство |
invalidCharError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении недопустимых символов в адресе электронного письма.
Значением по умолчанию является "Your e-mail address contains invalid characters.".
Реализация
public function get invalidCharError():String public function set invalidCharError(value:String):voidinvalidDomainError | свойство |
invalidDomainError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении суффикса (домена верхнего уровня) длиной не из 2, 3, 4 или 6 символов.
Значением по умолчанию является "The domain in your e-mail address is incorrectly formatted.".
Реализация
public function get invalidDomainError():String public function set invalidDomainError(value:String):voidinvalidIPDomainError | свойство |
invalidIPDomainError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении недопустимого IP-домена. IP-домен должен быть заключен в квадратные скобки.
Значением по умолчанию является "The IP domain in your e-mail address is incorrectly formatted.".
Реализация
public function get invalidIPDomainError():String public function set invalidIPDomainError(value:String):voidinvalidPeriodsInDomainError | свойство |
invalidPeriodsInDomainError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при наличии в домене многоточий.
Значением по умолчанию является "The domain in your e-mail address has continous periods.".
Реализация
public function get invalidPeriodsInDomainError():String public function set invalidPeriodsInDomainError(value:String):voidmissingAtSignError | свойство |
missingAtSignError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке в случае отсутствия в адресе электронной почты знака «@».
Значением по умолчанию является "An at sign (&64;) is missing in your e-mail address.".
Реализация
public function get missingAtSignError():String public function set missingAtSignError(value:String):voidmissingPeriodInDomainError | свойство |
missingPeriodInDomainError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при отсутствии в домене точки.
Значением по умолчанию является "The domain in your e-mail address is missing a period.".
Реализация
public function get missingPeriodInDomainError():String public function set missingPeriodInDomainError(value:String):voidmissingUsernameError | свойство |
missingUsernameError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при отсутствии имени пользователя.
Значением по умолчанию является "The username in your e-mail address is missing.".
Реализация
public function get missingUsernameError():String public function set missingUsernameError(value:String):voidtooManyAtSignsError | свойство |
tooManyAtSignsError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при наличии нескольких знаков «@» в адресе электронного письма. Это свойство является необязательным.
Значением по умолчанию является "Your e-mail address contains too many &64; characters.".
Реализация
public function get tooManyAtSignsError():String public function set tooManyAtSignsError(value:String):voidСведения о конструкторе
EmailValidator | () | Конструктор |
public function EmailValidator()| Язык версии: | 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 для каждого поля, проверенного средством проверки.
|
validateEmail | () | метод |
public static function validateEmail(validator:EmailValidator, value:Object, baseField:String):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удобный метод для вызова средства проверки в пользовательской функции проверки. Каждое стандартное средство проверки Flex имеет подобный удобный метод.
Параметры
validator:EmailValidator — Экземпляр EmailValidator.
| |
value:Object — Проверяемое поле.
| |
baseField:String — Текстовое представление подчиненного поля определяется в параметре value. Например, если параметр value имеет значение value.email, то baseField имеет значение email.
|
Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.
|
Связанные элементы API
Примеры Использование этого примера
EmailValidatorExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the EmailValidator. -->
<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>
<mx:EmailValidator source="{email}" property="text"
trigger="{myButton}" triggerEvent="click"
valid="Alert.show('Validation Succeeded!');"/>
</fx:Declarations>
<s:Panel title="EmailValidator Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter an e-mail address: ">
<s:TextInput id="email" 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