class ZIPCodeTextInput

The variant used to style the error string TextCallout child component in a theme.

To override this default variant, set the ZIPCodeTextInput.customErrorCalloutVariant property.

See also:

• ZIPCodeTextInput.customErrorCalloutVariant

• feathers.style.IVariantStyleObject.variant

• Feathers UI User Manual: Themes

Creates a new ZIPCodeTextInput object.

The default background skin for the text input, which is used when no other skin is defined for the current state with setSkinForState().

The following example passes a bitmap for the text input to use as a background skin:

input.backgroundSkin = new Bitmap(bitmapData);

See also:

• ZIPCodeTextInput.getSkinForState()

• ZIPCodeTextInput.setSkinForState()

See also:

• feathers.controls.ITextControl.baseline

The current state of the text input.

See also:

• feathers.controls.TextInputState

• FeathersEvent.STATE_CHANGE

A custom variant to set on the error callout, instead of ZIPCodeTextInput.CHILD_VARIANT_ERROR_CALLOUT.

The customErrorCalloutVariant will be not be used if the TextCallout already has a variant set.

See also:

• ZIPCodeTextInput.CHILD_VARIANT_ERROR_CALLOUT

• feathers.style.IVariantStyleObject.variant

The font styles used to render the text input's text when the text input is disabled.

In the following example, the text input's disabled text formatting is customized:

input.enabled = false;
input.disabledTextFormat = new TextFormat("Helvetica", 20, 0xee0000);

See also:

• ZIPCodeTextInput.textFormat

Indicates if the text input is editable.

The following example disables editing:

textInput.editable = false;

Determines if an embedded font is used or not.

In the following example, the text input uses embedded fonts:

input.embedFonts = true;

See also:

• ZIPCodeTextInput.textFormat

Creates the error callout, which must be of type feathers.controls.TextCallout.

In the following example, a custom error callout factory is provided:

textInput.errorCalloutFactory = () ->
{
	return new TextCallout();
};

See also:

• feathers.controls.TextCallout

Error text to display in a TextCallout when the text input has focus. When this value is not null the text input's currentState is changed to TextInputState.ERROR.

An empty string will change the background, but no TextCallout will appear on focus.

To clear an error, the errorString property must be set to null.

The following example displays an error string:

input.errorString = "Something is wrong";

See also:

• ZIPCodeTextInput.currentState

Indicates if the callout for the errorString is currently open or closed.

See also:

• ZIPCodeTextInput.errorString

An optional view displayed inside the text input, to the left of its text.

The following example passes a bitmap for the text input to use as a left view:

input.leftView = new Bitmap(bitmapData);

See also:

• ZIPCodeTextInput.rightView

• ZIPCodeTextInput.leftViewGap

The gap between the left view and the text.

The following example sets the left view's gap to 20 pixels:

input.leftViewGap = 20.0;

See also:

• ZIPCodeTextInput.leftView

The alpha value of the delimiter text field when it is displayed in an optional state.

The minimum space, in pixels, between the text input's bottom edge and the text input's content.

In the following example, the text input's bottom padding is set to 20 pixels:

input.paddingBottom = 20.0;

The minimum space, in pixels, between the text input's left edge and the text input's content.

In the following example, the text input's left padding is set to 20 pixels:

input.paddingLeft = 20.0;

The minimum space, in pixels, between the text input's right edge and the text input's content.

In the following example, the text input's right padding is set to 20 pixels:

input.paddingRight = 20.0;

The minimum space, in pixels, between the text input's top edge and the text input's content.

In the following example, the text input's top padding is set to 20 pixels:

input.paddingTop = 20.0;

Determines how to handle the final four digits of ZIP+4.

The following example requires the final four digits:

textInput.plus4Mode = REQUIRED;

An optional view displayed inside the text input, to the right of its text.

The following example passes a bitmap for the text input to use as a right view:

input.rightView = new Bitmap(bitmapData);

See also:

• ZIPCodeTextInput.leftView

• ZIPCodeTextInput.rightViewGap

The gap between the right view and the text.

The following example sets the right view's gap to 20 pixels:

input.rightViewGap = 20.0;

See also:

• ZIPCodeTextInput.rightView

The ZIP code string displayed by the text input. Returns a formatted ZIP code with a - character between the two parts. If the current ZIP code does not include a +4 part, and plus4Mode is not set to ZipCodePlus4Mode.REQUIRED, the - will be omitted.

The setter accepts either a string of 5 numeric digits, or a full ZIP+4 value with the - delimiter between the two parts, or all nine digits only with no delimiter. Partial ZIP and ZIP+4 values are allowed as well.

When the value of the text property changes, the text input will dispatch an event of type Event.CHANGE.

The following example sets the text input's text with a five digit ZIP Code value:

input.text = "12345";

The following example sets the text input's text with a ZIP+4 value:

input.text = "12345-6789";

The following example sets the text input's text to a partial ZIP-4 value:

input.text = "12345-6";

See also:

• ZIPCodeTextInput.textFormat

• openfl.events.Event.CHANGE

The font styles used to render the text input's text.

In the following example, the text input's formatting is customized:

input.textFormat = new TextFormat("Helvetica", 20, 0xcc0000);

See also:

• ZIPCodeTextInput.text

• ZIPCodeTextInput.getTextFormatForState()

• ZIPCodeTextInput.setTextFormatForState()

• ZIPCodeTextInput.embedFonts

How the content is positioned vertically (along the y-axis) within the text input.

The following example aligns the text input's content to the top:

input.verticalAlign = TOP;

See also:

• feathers.layout.VerticalAlign.TOP

• feathers.layout.VerticalAlign.MIDDLE

• feathers.layout.VerticalAlign.BOTTOM

• feathers.layout.VerticalAlign.JUSTIFY

Gets the skin to be used by the text input when its currentState property matches the specified state value.

If a skin is not defined for a specific state, returns null.

See also:

• ZIPCodeTextInput.setSkinForState()

• ZIPCodeTextInput.backgroundSkin

• ZIPCodeTextInput.currentState

• feathers.controls.TextInputState

Gets the text format to be used by the text input when its currentState property matches the specified state value.

If a text format is not defined for a specific state, returns null.

See also:

• ZIPCodeTextInput.setTextFormatForState()

• ZIPCodeTextInput.textFormat

• ZIPCodeTextInput.currentState

• feathers.controls.TextInputState

Sets all four padding properties to the same value.

See also:

• ZIPCodeTextInput.paddingTop

• ZIPCodeTextInput.paddingRight

• ZIPCodeTextInput.paddingBottom

• ZIPCodeTextInput.paddingLeft

Set the skin to be used by the text input when its currentState property matches the specified state value.

If a skin is not defined for a specific state, the value of the backgroundSkin property will be used instead.

See also:

• ZIPCodeTextInput.getSkinForState()

• ZIPCodeTextInput.backgroundSkin

• ZIPCodeTextInput.currentState

• feathers.controls.TextInputState

Set the text format to be used by the text input when its currentState property matches the specified state value.

If a text format is not defined for a specific state, the value of the textFormat property will be used instead.

See also:

• ZIPCodeTextInput.getTextFormatForState()

• ZIPCodeTextInput.textFormat

• ZIPCodeTextInput.currentState

• feathers.controls.TextInputState