| Пакет | mx.validators |
| Класс | public class CreditCardValidator |
| Наследование | CreditCardValidator  Validator EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указать вводимые данные в CreditCardValidator можно двумя способами:
- Используйте свойства
cardNumberSourceиcardNumberPropertyдля определения местоположения номера кредитной карты и свойстваcardTypeSourceиcardTypePropertyдля определения местоположения типа проверяемой кредитной карты. - Используйте свойства
sourceиpropertyдля определения одного объекта. Объект должен содержать следующие поля:-
cardType: указывает тип проверяемой кредитной карты.В MXML используются значения:
American Express,Diners Club,Discover,MasterCardилиVisa.В ActionScript используются статические константы
CreditCardValidatorCardType.MASTER_CARD,CreditCardValidatorCardType.VISAилиCreditCardValidatorCardType.AMERICAN_EXPRESSCreditCardValidatorCardType.DISCOVERилиCreditCardValidatorCardType.DINERS_CLUB. -
cardNumber: указывает номер проверяемой карты.
-
Для выполнения проверки используются следующие рекомендации:
Длина:
- Visa: 13 или 16 цифр
- MasterCard: 16 цифр
- Discover: 16 цифр
- American Express: 15 цифр
- Diners Club: 14 цифр или 16 цифр, если она функционирует так же, как MasterCard
- Visa: 4
- MasterCard: 51 – 55
- Discover: 6011
- American Express: 34 или 37
- Diners Club: 300 – 305, 36 или 38, 51 – 55
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <mx:CreditCardValidator> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:CreditCardValidator
allowedFormatChars=" -"
cardNumberListener="Object specified by cardNumberSource"
cardNumberProperty="No default"
cardNumberSource="No default"
cardTypeListener="Object specified by cardTypeSource"
cardTypeProperty="No default"
cardTypeSource="No default"
invalidCharError= "Invalid characters in your credit card number. (Enter numbers only.)"
invalidNumberError="The credit card number is invalid."
noNumError="No credit card number is specified."
noTypeError="No credit card type is specified or the type is not valid."
wrongLengthError="Your credit card number contains the wrong number of digits."
wrongTypeError="Incorrect card type is specified."
/>
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
| allowedFormatChars : String
Набор символов форматирования, допустимых в поле cardNumber. | CreditCardValidator | ||
| cardNumberListener : IValidatorListener
Компонент, прослушивающий результат проверки подчиненного поля карты. | CreditCardValidator | ||
| cardNumberProperty : String
Имя свойства проверяемой кредитной карты. | CreditCardValidator | ||
| cardNumberSource : Object
Объект, содержащий значение поля номера карты. | CreditCardValidator | ||
| cardTypeListener : IValidatorListener
Компонент, прослушивающий результат проверки подчиненного поля типа карты. | CreditCardValidator | ||
| cardTypeProperty : String
Имя свойства проверяемого типа карты. | CreditCardValidator | ||
| cardTypeSource : Object
Объект, содержащий значение поля типа карты. | CreditCardValidator | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| enabled : Boolean
Установка этого значения на false помешает выполнению проверки средством проверки. | Validator | |
| invalidCharError : String
Сообщение об ошибке при обнаружении поля cardNumber с недопустимыми символами. | CreditCardValidator | ||
| invalidNumberError : String
Сообщение об ошибке при обнаружении недопустимого номера кредитной карты. | CreditCardValidator | ||
| listener : Object
Указывает прослушиватель проверки. | Validator | |
| noNumError : String
Сообщение об ошибке при обнаружении пустого поля cardNumber. | CreditCardValidator | ||
| noTypeError : String
Сообщение об ошибке при обнаружении пустого поля cardType. | CreditCardValidator | ||
| 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
Сообщение об ошибке при обнаружении поля cardNumber с неправильным количеством цифр для указанного типа кредитной карты. | CreditCardValidator | ||
| wrongTypeError : String
Сообщение об ошибке при обнаружении поля cardType с недопустимым типом кредитной карты. | CreditCardValidator | ||
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | CreditCardValidator | ||
| 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 | |
[статические]
Удобный метод для выполнения вызова средства проверки. | CreditCardValidator | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Метод | Определено | ||
|---|---|---|---|
|
Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки. | Validator | |
[переопределить]
Переопределяет метод базового класса doValidation() для проверки номера кредитной карты. | CreditCardValidator | ||
|
Возвращает проверяемый объект. | 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 |
Набор символов форматирования, допустимых в поле cardNumber.
Значением по умолчанию является " -" (space and dash).
Реализация
public function get allowedFormatChars():String public function set allowedFormatChars(value:String):voidcardNumberListener | свойство |
cardNumberListener:IValidatorListener| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Компонент, прослушивающий результат проверки подчиненного поля карты. Если он не указан, используется значение, указанное в свойстве cardNumberSource.
Реализация
public function get cardNumberListener():IValidatorListener public function set cardNumberListener(value:IValidatorListener):voidcardNumberProperty | свойство |
public var cardNumberProperty:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Имя свойства проверяемой кредитной карты. Этот атрибут является необязательным, но если указано свойство cardNumberSource, следует указать также и это свойство.
cardNumberSource | свойство |
cardNumberSource:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Объект, содержащий значение поля номера карты. Если для этого свойства указано значение, следует также определить значение свойства cardNumberProperty. Не используйте это свойство, если определены свойства source и property.
Реализация
public function get cardNumberSource():Object public function set cardNumberSource(value:Object):voidcardTypeListener | свойство |
cardTypeListener:IValidatorListener| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Компонент, прослушивающий результат проверки подчиненного поля типа карты. Если он не указан, то используется значение, указанное в свойстве cardTypeSource.
Реализация
public function get cardTypeListener():IValidatorListener public function set cardTypeListener(value:IValidatorListener):voidcardTypeProperty | свойство |
public var cardTypeProperty:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Имя свойства проверяемого типа карты. Этот атрибут является необязательным, но если определено свойство cardTypeSource, следует также указать это свойство.
В MXML допустимыми значениями являются:
American ExpressDiners ClubDiscoverMasterCardVisa
В ActionScript для определения этого свойства можно использовать следующие константы:
CreditCardValidatorCardType.AMERICAN_EXPRESS, CreditCardValidatorCardType.DINERS_CLUB, CreditCardValidatorCardType.DISCOVER, CreditCardValidatorCardType.MASTER_CARD и CreditCardValidatorCardType.VISA.
Связанные элементы API
cardTypeSource | свойство |
cardTypeSource:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Объект, содержащий значение поля типа карты. Если для этого свойства указано значение, следует также определить значение свойства cardTypeProperty. Не используйте это свойство, если определены свойства source и property.
Реализация
public function get cardTypeSource():Object public function set cardTypeSource(value:Object):voidinvalidCharError | свойство |
invalidCharError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении поля cardNumber с недопустимыми символами.
Значением по умолчанию является "Invalid characters in your credit card number. (Enter numbers only.)".
Реализация
public function get invalidCharError():String public function set invalidCharError(value:String):voidinvalidNumberError | свойство |
invalidNumberError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении недопустимого номера кредитной карты.
Значением по умолчанию является "The credit card number is invalid.".
Реализация
public function get invalidNumberError():String public function set invalidNumberError(value:String):voidnoNumError | свойство |
noNumError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении пустого поля cardNumber.
Значением по умолчанию является "No credit card number is specified.".
Реализация
public function get noNumError():String public function set noNumError(value:String):voidnoTypeError | свойство |
noTypeError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении пустого поля cardType.
Значением по умолчанию является "No credit card type is specified or the type is not valid.".
Реализация
public function get noTypeError():String public function set noTypeError(value:String):voidwrongLengthError | свойство |
wrongLengthError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении поля cardNumber с неправильным количеством цифр для указанного типа кредитной карты.
Значением по умолчанию является "Your credit card number contains the wrong number of digits.".
Реализация
public function get wrongLengthError():String public function set wrongLengthError(value:String):voidwrongTypeError | свойство |
wrongTypeError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении поля cardType с недопустимым типом кредитной карты. Для поля cardType следует использовать предопределенные константы: CreditCardValidatorCardType.MASTER_CARD, CreditCardValidatorCardType.VISA, CreditCardValidatorCardType.AMERICAN_EXPRESS, CreditCardValidatorCardType.DISCOVER или CreditCardValidatorCardType.DINERS_CLUB.
Значением по умолчанию является "Incorrect card type is specified.".
Реализация
public function get wrongTypeError():String public function set wrongTypeError(value:String):voidCreditCardValidator | () | Конструктор |
public function CreditCardValidator()| Язык версии: | 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 для каждого поля, проверенного средством проверки.
|
validateCreditCard | () | метод |
public static function validateCreditCard(validator:CreditCardValidator, value:Object, baseField:String):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удобный метод для выполнения вызова средства проверки. Каждое стандартное средство проверки Flex имеет подобный удобный метод.
Параметры
validator:CreditCardValidator — Экземпляр CreditCardValidator.
| |
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 CreditCardValidator. -->
<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>
<!-- Define model for the credit card data. -->
<fx:Model id="creditcard">
<card>
<cardType>{cardTypeCombo.selectedItem.data}</cardType>
<cardNumber>{cardNumberInput.text}</cardNumber>
</card>
</fx:Model>
<mx:CreditCardValidator id="ccV"
cardTypeSource="{creditcard}" cardTypeProperty="cardType"
cardNumberSource="{creditcard}" cardNumberProperty="cardNumber"
trigger="{myButton}" triggerEvent="click"
cardTypeListener="{cardTypeCombo}"
cardNumberListener="{cardNumberInput}"
valid="Alert.show('Validation Succeeded!');"/>
</fx:Declarations>
<s:Panel title="CreditCardValidator Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form id="creditCardForm" left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Card Type">
<mx:ComboBox id="cardTypeCombo">
<mx:dataProvider>
<fx:Object label="American Express" data="American Express"/>
<fx:Object label="Diners Club" data="Diners Club"/>
<fx:Object label="Discover" data="Discover"/>
<fx:Object label="MasterCard" data="MasterCard"/>
<fx:Object label="Visa" data="Visa"/>
</mx:dataProvider>
</mx:ComboBox>
</mx:FormItem>
<mx:FormItem label="Credit Card Number">
<s:TextInput id="cardNumberInput"/>
</mx:FormItem>
<mx:FormItem>
<s:Button id="myButton" label="Check Credit"/>
</mx:FormItem>
</mx:Form>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 11:34 AM Z