Пакет | mx.formatters |
Класс | public class PhoneFormatter |
Наследование | PhoneFormatter Formatter Object |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Для семизначного формата, принятого в США, предусмотрена функция быстрого доступа. При установленном значении для свойства areaCode
и использовании семизначной строки формата (###-####), к возвращаемой строке с семизначным значением автоматически добавляется код зоны. Форматом кода зоны по умолчанию является (###). Для изменения этого формата используется свойство areaCodeFormat
. Код зоны можно отформатировать любым способом, но он обязательно должен содержать три числовых заполнителя.
В случае ошибки возвращается пустая строка, а строка с описанием ошибки сохраняется в свойстве error
. Свойство error
может иметь одно из следующих значений:
-
Invalid value
означает, что методуformat()
было передано недопустимое числовое значение. Значение должно являться допустимым числом в виде номера или строки; при использовании в значении количества цифр, отличного от указанного в строке формата, значение считается недопустимым. -
Invalid format
означает, что какой-либо из символов в свойствеformatString
не является допустимым символом, указанным в свойствеvalidPatternChars
, либо свойствоareaCodeFormat
указано, но не содержит трех числовых заполнителей.
The <mx:PhoneFormatter>
tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:PhoneFormatter areaCode="-1" areaCodeFormat="(###)" formatString="(###) ###-####" validPatternChars="+()#-. " />
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
areaCode : Object
Номер кода зоны, добавляемый к семизначному телефонному номеру в формате, принятом в США, для создания десятизначного телефонного номера. | PhoneFormatter | ||
areaCodeFormat : String
Формат кода зоны по умолчанию, если визуализация свойства areacode выполняется с использованием семизначного формата. | PhoneFormatter | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
error : String
Описание, сохраняемое средством форматирования при появлении ошибки. | Formatter | ||
formatString : String
Строка, которая содержит символы маски, представляющие указанный формат телефонного номера. | PhoneFormatter | ||
validPatternChars : String
Список допустимых символов для использования в свойстве formatString. | PhoneFormatter |
Метод | Определено | ||
---|---|---|---|
Конструктор. | PhoneFormatter | ||
[переопределить]
Форматирует строку в виде телефонного номера. | PhoneFormatter | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Возвращает элементарное значение заданного объекта. | Object |
areaCode | свойство |
areaCode:Object
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Номер кода зоны, добавляемый к семизначному телефонному номеру в формате, принятом в США, для создания десятизначного телефонного номера. Значение -1
указывает, что код зоны не добавляется.
Значением по умолчанию является -1.
Реализация
public function get areaCode():Object
public function set areaCode(value:Object):void
areaCodeFormat | свойство |
areaCodeFormat:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Формат кода зоны по умолчанию, если визуализация свойства areacode
выполняется с использованием семизначного формата.
Значением по умолчанию является "(###) ".
Реализация
public function get areaCodeFormat():String
public function set areaCodeFormat(value:String):void
formatString | свойство |
formatString:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Строка, которая содержит символы маски, представляющие указанный формат телефонного номера.
Значением по умолчанию является "(###) ###-####".
Реализация
public function get formatString():String
public function set formatString(value:String):void
validPatternChars | свойство |
validPatternChars:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Список допустимых символов для использования в свойстве formatString
. Это свойство используется при проверке свойства formatString
.
Значением по умолчанию является "+()#- .".
Реализация
public function get validPatternChars():String
public function set validPatternChars(value:String):void
PhoneFormatter | () | Конструктор |
public function PhoneFormatter()
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
format | () | метод |
override public function format(value:Object):String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Форматирует строку в виде телефонного номера. Если отформатировать значение невозможно, возвращается пустая строка, и описание ошибки записывается в свойство error
.
Параметры
value:Object — Значение для форматирования.
|
String — Отформатированная строка. В случае ошибки эта строка будет пустой. Описание состояния ошибки записывается в свойство error .
|
<?xml version="1.0" encoding="utf-8"?> <!-- Simple example to demonstrate PhoneFormatter. --> <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> <![CDATA[ import mx.events.ValidationResultEvent; private var vResult:ValidationResultEvent; // Event handler to validate and format input. private function Format():void { vResult = pnVal.validate(); if (vResult.type == ValidationResultEvent.VALID) { formattedPhone.text = phoneFormatter.format(phone.text); } else { formattedPhone.text = ""; } } ]]> </fx:Script> <fx:Declarations> <mx:PhoneFormatter id="phoneFormatter" formatString="(###) ###-####" validPatternChars="#-() "/> <mx:PhoneNumberValidator id="pnVal" source="{phone}" property="text" allowedFormatChars=""/> </fx:Declarations> <s:Panel title="PhoneFormatter Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <mx:Form left="10" right="10" top="10" bottom="10"> <mx:FormItem label="Enter a 10-digit phone number:"> <s:TextInput id="phone" text="" width="75%"/> </mx:FormItem> <mx:FormItem label="Formatted phone number: "> <s:TextInput id="formattedPhone" text="" width="75%" editable="false"/> </mx:FormItem> <mx:FormItem> <s:Button label="Validate and Format" click="Format();"/> </mx:FormItem> </mx:Form> </s:Panel> </s:Application>
Tue Jun 12 2018, 11:34 AM Z