PhoneNumberValidator

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

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Класс PhoneNumberValidator проверяет строку как допустимый номер телефона. Допустимый номер телефона содержит, по крайней мере, 10 цифр плюс дополнительные символы форматирования. Средство проверки не проверяет фактическое существование номера телефона.

Синтаксис MXML expanded

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

The <mx:PhoneNumberValidator> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:PhoneNumberValidator 
    allowedFormatChars="()- .+" 
    invalidCharError="Your telephone number contains invalid characters."
 	  minDigits="10"
    wrongLengthError="Your telephone number must contain at least 10 digits."
  />

Посмотреть примеры

Общедоступные свойства

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

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

	Свойство		Определено
		allowedFormatChars : String Набор допустимых символов форматирования.	PhoneNumberValidator
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		enabled : Boolean Установка этого значения на false помешает выполнению проверки средством проверки.	Validator
		invalidCharError : String Сообщение об ошибке при обнаружении в значении недопустимых символов.	PhoneNumberValidator
		listener : Object Указывает прослушиватель проверки.	Validator
		minDigits : Object Минимальное число цифр для допустимого номера телефона.	PhoneNumberValidator
		property : String Строка с именем свойства для объекта source, содержащего проверяемое значение.	Validator
		required : Boolean = true Значение true указывает на то, что ошибка проверки вызвана отсутствующим или пустым значением.	Validator
		requiredFieldError : String Сообщение об ошибке, если значение отсутствует, а свойство required имеет значение true.	Validator
		source : Object Указывает объект, содержащий проверяемое свойство.	Validator
		trigger : IEventDispatcher Указывает компонент, генерирующий запускающее средство проверки событие.	Validator
		triggerEvent : String Указывает запускающее проверку событие.	Validator
		wrongLengthError : String Сообщение об ошибке при обнаружении значения из менее чем 10 цифр.	PhoneNumberValidator

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

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

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

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

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

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

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

	Метод		Определено
		PhoneNumberValidator() Конструктор.	PhoneNumberValidator
		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
		validatePhoneNumber(validator:PhoneNumberValidator, value:Object, baseField:String):Array [статические] Удобный метод для вызова средства проверки в пользовательской функции проверки.	PhoneNumberValidator
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

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

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

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

	Метод		Определено
		addListenerHandler():void Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки.	Validator
		doValidation(value:Object):Array [переопределить] Переопределение метода базового класса doValidation() для проверки номера телефона.	PhoneNumberValidator
		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

Защищенные константы

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

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

	Константа		Определено

Сведения о свойстве

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

invalidCharError

свойство

invalidCharError:String

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Сообщение об ошибке при обнаружении в значении недопустимых символов.

Значением по умолчанию является "Your telephone number contains invalid characters.".

Реализация
public function get invalidCharError():String
public function set invalidCharError(value:String):void

minDigits

свойство

minDigits:Object

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Минимальное число цифр для допустимого номера телефона. Значение NaN означает игнорирование свойства.

Значением по умолчанию является 10.

Реализация
public function get minDigits():Object
public function set minDigits(value:Object):void

wrongLengthError

свойство

wrongLengthError:String

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Сообщение об ошибке при обнаружении значения из менее чем 10 цифр.

Значением по умолчанию является "Your telephone number must contain at least 10 digits.".

Реализация
public function get wrongLengthError():String
public function set wrongLengthError(value:String):void

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

()

Конструктор

public function PhoneNumberValidator()

Язык версии:

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 для каждого поля, проверенного средством проверки.

validatePhoneNumber

()

метод

public static function validatePhoneNumber(validator:PhoneNumberValidator, value:Object, baseField:String):Array

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Удобный метод для вызова средства проверки в пользовательской функции проверки. Каждое стандартное средство проверки Flex имеет подобный удобный метод.

Параметры

	`validator:PhoneNumberValidator` — Экземпляр PhoneNumberValidator.

	`value:Object` — Проверяемое поле.

	`baseField:String` — Текстовое представление подчиненного поля определяется в параметре `value`. Например, если параметр `value` имеет значение value.phone, то `baseField` имеет значение phone.

Возвращает

Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.

Связанные элементы API

mx.validators.ValidationResult

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

PhoneNumberValidatorExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the PhoneNumberValidator. -->
<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:PhoneNumberValidator source="{phone}" property="text" 
                trigger="{myButton}" triggerEvent="click"
                valid="Alert.show('Validation Succeeded!');"
                invalid="Alert.show('Validation Failed!');" />
    </fx:Declarations>

    <s:Panel title="Phone Number Validator Panel"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <mx:Form left="10" right="10" top="10" bottom="10">
            <mx:FormItem label="Enter 10-digit phone number: ">
                <s:TextInput id="phone" width="100%"/>
            </mx:FormItem>
            <mx:FormItem >
                <s:Button id="myButton" label="Validate" />
            </mx:FormItem>
        </mx:Form>
    </s:Panel>

</s:Application>

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

PhoneNumberValidator - AS3 Flex

Классы x

allowedFormatChars

invalidCharError

minDigits

wrongLengthError