| Пакет | 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указано, но не содержит трех числовых заполнителей.
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <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):voidareaCodeFormat | свойство |
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):voidformatString | свойство |
formatString:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Строка, которая содержит символы маски, представляющие указанный формат телефонного номера.
Значением по умолчанию является "(###) ###-####".
Реализация
public function get formatString():String public function set formatString(value:String):voidvalidPatternChars | свойство |
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):voidPhoneFormatter | () | Конструктор |
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