Пакет | mx.validators |
Класс | public class ZipCodeValidator |
Наследование | ZipCodeValidator Validator EventDispatcher Object |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
The <mx:ZipCodeValidator>
tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:ZipCodeValidator allowedFormatChars=" -" domain="US Only | US or Canada | Canada Only" invalidCharError="The ZIP code contains invalid characters." invalidDomainError="The domain parameter is invalid. It must be either 'US Only', 'Canada Only', or 'US or Canada'." wrongCAFormatError="The Canadian postal code must be formatted 'A1B 2C3'." wrongLengthError="The ZIP code must be 5 digits or 5+4 digits." wrongUSFormatError="The ZIP+4 code must be formatted '12345-6789'." />
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
allowedFormatChars : String
Набор символов форматирования, допустимых в почтовом индексе. | ZipCodeValidator | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
domain : String
Тип проверяемого почтового индекса. | ZipCodeValidator | ||
enabled : Boolean
Установка этого значения на false помешает выполнению проверки средством проверки. | Validator | ||
invalidCharError : String
Сообщение об ошибке при обнаружении недопустимых символов в почтовом индексе. | ZipCodeValidator | ||
invalidDomainError : String
Сообщение об ошибке при обнаружении недопустимого значения свойства domain. | ZipCodeValidator | ||
listener : Object
Указывает прослушиватель проверки. | Validator | ||
property : String
Строка с именем свойства для объекта source, содержащего проверяемое значение. | Validator | ||
required : Boolean = true
Значение true указывает на то, что ошибка проверки вызвана отсутствующим или пустым значением. | Validator | ||
requiredFieldError : String
Сообщение об ошибке, если значение отсутствует, а свойство required имеет значение true. | Validator | ||
source : Object
Указывает объект, содержащий проверяемое свойство. | Validator | ||
trigger : IEventDispatcher
Указывает компонент, генерирующий запускающее средство проверки событие. | Validator | ||
triggerEvent : String
Указывает запускающее проверку событие. | Validator | ||
wrongCAFormatError : String
Сообщение об ошибке при обнаружении недопустимого значения почтового индекса Канады. | ZipCodeValidator | ||
wrongLengthError : String
Сообщение об ошибке при обнаружении недопустимого значения почтового индекса США. | ZipCodeValidator | ||
wrongUSFormatError : String
Сообщение об ошибке в случае некорректно отформатированного почтового индекса. | ZipCodeValidator |
Метод | Определено | ||
---|---|---|---|
Конструктор. | ZipCodeValidator | ||
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 | ||
[статические]
Удобный метод для выполнения вызова средства проверки. | ZipCodeValidator | ||
Возвращает элементарное значение заданного объекта. | Object | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher |
Метод | Определено | ||
---|---|---|---|
Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки. | Validator | ||
[переопределить]
Переопределяет метод базового класса doValidation() для проверки почтового индекса. | ZipCodeValidator | ||
Возвращает проверяемый объект. | 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 |
Набор символов форматирования, допустимых в почтовом индексе. Он не может содержать цифры или буквы [a-z A-Z].
Значением по умолчанию является " -"..
Реализация
public function get allowedFormatChars():String
public function set allowedFormatChars(value:String):void
domain | свойство |
domain:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Тип проверяемого почтового индекса. В MXML допустимыми значениями являются US or Canada
, US Only
и Canada Only
.
В ActionScript можно использовать следующие константы для определения этого свойства: ZipCodeValidatorDomainType.US_ONLY
, ZipCodeValidatorDomainType.US_OR_CANADA
или ZipCodeValidatorDomainType.CANADA_ONLY
.
Значением по умолчанию является ZipCodeValidatorDomainType.US_ONLY.
Реализация
public function get domain():String
public function set domain(value:String):void
invalidCharError | свойство |
invalidCharError:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении недопустимых символов в почтовом индексе.
Значением по умолчанию является "The ZIP code 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 |
Сообщение об ошибке при обнаружении недопустимого значения свойства domain
.
Значением по умолчанию является "The domain parameter is invalid. It must be either 'US Only' or 'US or Canada'.".
Реализация
public function get invalidDomainError():String
public function set invalidDomainError(value:String):void
wrongCAFormatError | свойство |
wrongCAFormatError:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении недопустимого значения почтового индекса Канады.
Значением по умолчанию является "The Canadian postal code must be formatted 'A1B 2C3'.".
Реализация
public function get wrongCAFormatError():String
public function set wrongCAFormatError(value:String):void
wrongLengthError | свойство |
wrongLengthError:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении недопустимого значения почтового индекса США.
Значением по умолчанию является "The ZIP code must be 5 digits or 5+4 digits.".
Реализация
public function get wrongLengthError():String
public function set wrongLengthError(value:String):void
wrongUSFormatError | свойство |
wrongUSFormatError:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке в случае некорректно отформатированного почтового индекса.
Значением по умолчанию является "The ZIP+4 code must be formatted '12345-6789'.".
Реализация
public function get wrongUSFormatError():String
public function set wrongUSFormatError(value:String):void
ZipCodeValidator | () | Конструктор |
public function ZipCodeValidator()
Язык версии: | 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 для каждого поля, проверенного средством проверки.
|
validateZipCode | () | метод |
public static function validateZipCode(validator:ZipCodeValidator, value:Object, baseField:String):Array
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удобный метод для выполнения вызова средства проверки. Каждое стандартное средство проверки Flex имеет подобный удобный метод.
Параметры
validator:ZipCodeValidator — Экземпляр ZipCodeValidator.
| |
value:Object — Проверяемое поле.
| |
baseField:String — Текстовое представление подчиненного поля определяется в параметре value . Например, если параметр value определен как value.zipCode, то baseField имеет значение zipCode .
|
Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.
|
Связанные элементы API
<?xml version="1.0" encoding="utf-8"?> <!-- Simple example to demonstrate the ZipCodeValidator. --> <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:ZipCodeValidator source="{zip}" property="text" trigger="{myButton}" triggerEvent="click" valid="Alert.show('Validation Succeeded!');" invalid="Alert.show('Validation Failed!');"/> </fx:Declarations> <s:Panel title="ZipcodeValidator Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <mx:Form left="10" right="10" top="10" bottom="10"> <mx:FormItem label="Enter a 5 or 9 digit U.S. Zip code: "> <s:TextInput id="zip" 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