EmailValidator

Пакет	mx.validators
Класс	public class EmailValidator
Наследование	EmailValidator Validator EventDispatcher Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Класс EmailValidator проверяет наличие в строке одного знака @, точки в имени домена и наличие в суффиксе домена верхнего уровня двух, трех, четырех или шести символов. Имена IP-домена являются допустимыми, если они заключены в квадратные скобки. Средство проверки не проверяет фактическое существование имени домена и имени пользователя.

Можно использовать имена IP-домена, если они заключены в квадратные скобки; например, myname@[206.132.22.1]. Можно использовать отдельные IP-номера от 0 до 255.

Синтаксис MXML expanded

Скрыть синтаксис MXML

The <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

Защищенные свойства

Скрыть унаследованные защищенные свойства

Показать унаследованные защищенные свойства

	Свойство		Определено
		actualListeners : Array [только для чтения] Содержит массив объектов прослушивателей при их наличии или исходный объект.	Validator
		actualTrigger : IEventDispatcher [только для чтения] Содержит объект-триггер при его наличии или исходный объект.	Validator
		resourceManager : IResourceManager [только для чтения] Ссылка на объект, управляющий всеми локализованными ресурсами приложения.	Validator
		subFields : Array Массив строк, содержащий имена свойств из объекта value, переданного в метод validate().	Validator

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		EmailValidator() Конструктор.	EmailValidator
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		initialized(document:Object, id:String):void Вызывается автоматически компилятором MXML при создании класса Validator с помощью тега MXML.	Validator
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent Выполняет проверку и дополнительно оповещает прослушиватели результата.	Validator
		validateAll(validators:Array):Array [статические] Вызывает все средства проверки в массиве validators.	Validator
		validateEmail(validator:EmailValidator, value:Object, baseField:String):Array [статические] Удобный метод для вызова средства проверки в пользовательской функции проверки.	EmailValidator
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

Защищенные методы

Скрыть унаследованные защищенные методы

Показать унаследованные защищенные методы

	Метод		Определено
		addListenerHandler():void Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки.	Validator
		doValidation(value:Object):Array [переопределить] Переопределение метода базового класса doValidation() для проверки адреса электронного письма.	EmailValidator
		getValueFromSource():Object Возвращает проверяемый объект.	Validator
		handleResults(errorResults:Array):ValidationResultEvent Возвращает ValidationResultEvent из массива результатов ошибки.	Validator
		isRealValue(value:Object):Boolean Возвращает true, если value не имеет значения null.	Validator
		removeListenerHandler():void Отключает все прослушиватели для событий valid и invalid, передаваемых из средства проверки.	Validator
		resourcesChanged():void Этот метод вызывается при создании класса Validator и каждый раз при отправке ResourceManager события change для указания изменения локализованных ресурсов сходным образом.	Validator

События

Дополнительные сведения о событиях

Скрыть унаследованные события

Показать унаследованные события

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher
invalid	Передается при сбое проверки.	Validator
valid	Передается при успешном завершении проверки.	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):void

invalidDomainError

свойство

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):void

invalidIPDomainError

свойство

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):void

invalidPeriodsInDomainError

свойство

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):void

missingAtSignError

свойство

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):void

missingPeriodInDomainError

свойство

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):void

missingUsernameError

свойство

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):void

tooManyAtSignsError

свойство

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

Сведения о конструкторе

()

Конструктор

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

mx.validators.ValidationResult

Примеры Использование этого примера

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>

Юридическая информация | Политика конфиденциальности онлайн

EmailValidator - AS3 Flex

Пакетыx

Элементы языка

Приложения

Пакет mx.validators

invalidCharError

invalidDomainError

invalidIPDomainError

invalidPeriodsInDomainError

missingAtSignError

missingPeriodInDomainError

missingUsernameError

tooManyAtSignsError

EmailValidator

doValidation

validateEmail