Dojo/Form/Element/CurrencyTextBox.php

Show: inherited
Table of Contents

Zend Framework

LICENSE

This source file is subject to the new BSD license that is bundled with this package in the file LICENSE.txt. It is also available through the world-wide-web at this URL: http://framework.zend.com/license/new-bsd If you did not receive a copy of the license and are unable to obtain it through the world-wide-web, please send an email to [email protected] so we can send you a copy immediately.

Category
Zend  
Copyright
Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)  
License
New BSD License  
Package
Zend_Dojo  
Subpackage
Form_Element  

\Zend_Dojo_Form_Element_CurrencyTextBox

Package: Zend\Dojo\Form\Element

CurrencyTextBox dijit

Parent(s)
\Zend_Dojo_Form_Element_NumberTextBox < \Zend_Dojo_Form_Element_ValidationTextBox < \Zend_Dojo_Form_Element_TextBox < \Zend_Dojo_Form_Element_Dijit < \Zend_Form_Element
Copyright
Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)  
License
New BSD License  
Uses
\global\Zend_Dojo_Form_Element_NumberTextBox  
Version
$Id: CurrencyTextBox.php 24593 2012-01-05 20:35:02Z matthew $  

Constants

Properties

Propertyprotectedarray $_allowedTypes = array('decimal', 'scientific', 'percent', 'currency')
inherited

Allowed numeric type formats

Inherited from: \Zend_Dojo_Form_Element_NumberTextBox::$$_allowedTypes
Default valuearray('decimal', 'scientific', 'percent', 'currency')Details
Type
array
Inherited_from
\Zend_Dojo_Form_Element_NumberTextBox::$$_allowedTypes  
Propertyprotectedbool $_isPartialRendering = false

This is to allow execution of logic inside the render() methods of child elements during the magic call while skipping the parent render() method.

Default valuefalseDetails
Type
bool
Inherited_from
\Zend_Form_Element::$$_isPartialRendering  
Inherited_from
\Zend_Dojo_Form_Element_Dijit::$$_isPartialRendering  
Inherited_from
\Zend_Dojo_Form_Element_TextBox::$$_isPartialRendering  
Inherited_from
\Zend_Dojo_Form_Element_ValidationTextBox::$$_isPartialRendering  
Inherited_from
\Zend_Dojo_Form_Element_NumberTextBox::$$_isPartialRendering  
Propertypublicstring $helper = 'CurrencyTextBox'

Use CurrencyTextBox dijit view helper

Default value'CurrencyTextBox'Details
Type
string

Methods

methodpublic__call(string $method, array $args) : string

Call renderDecoratorName() to render a specific decorator.

Parameters
Name Type Description
$method string
$args array
Returns
Type Description
string
Throws
Exception Description
\Zend_Form_Exception for invalid decorator or invalid method call
methodpublic__construct(mixed $spec, mixed $options = null) : void

$spec may be: - string: name of element - array: options with which to configure element - Zend_Config: Zend_Config with options for configuring element

Parameters
Name Type Description
$spec mixed
$options mixed
Throws
Exception Description
\Zend_Form_Exception if no element name after initialization
methodpublic__get(string $key) : mixed

Prevents access to properties beginning with '_'.

Parameters
Name Type Description
$key string
Returns
Type Description
mixed
methodpublic__set(string $key, mixed $value) : \voide
Parameters
Name Type Description
$key string
$value mixed
Returns
Type Description
\voide
methodprotected_castBoolToString(mixed $item, string $key) : void
Parameters
Name Type Description
$item mixed
$key string
methodprotected_getDecorator(string $name, null | array $options) : \Zend_Form_Decorator_Interface
Parameters
Name Type Description
$name string
$options null | array
Returns
Type Description
\Zend_Form_Decorator_Interface
methodprotected_loadDecorator(array $decorator, mixed $name) : \Zend_Form_Decorator_Interface
Parameters
Name Type Description
$decorator array

Decorator type and options

$name mixed

Decorator name or alias

Returns
Type Description
\Zend_Form_Decorator_Interface
methodpublicaddDecorator(string | \Zend_Form_Decorator_Interface $decorator, array | \Zend_Config $options = null) : \Zend_Form_Element
Parameters
Name Type Description
$decorator string | \Zend_Form_Decorator_Interface
$options array | \Zend_Config

Options with which to initialize decorator

Returns
Type Description
\Zend_Form_Element
methodpublicaddError(string $message) : \Zend_Form_Element
Parameters
Name Type Description
$message string
Returns
Type Description
\Zend_Form_Element
methodpublicaddErrorMessage(string $message) : \Zend_Form_Element
Parameters
Name Type Description
$message string
Returns
Type Description
\Zend_Form_Element
methodpublicaddErrorMessages(array $messages) : \Zend_Form_Element
Parameters
Name Type Description
$messages array
Returns
Type Description
\Zend_Form_Element
methodpublicaddErrors(array $messages) : \Zend_Form_Element
Parameters
Name Type Description
$messages array
Returns
Type Description
\Zend_Form_Element
methodpublicaddPrefixPath(string $prefix, string $path, string $type = null) : \Zend_Form_Element

If no $type specified, assumes it is a base path for both filters and validators, and sets each according to the following rules: - decorators: $prefix = $prefix . '_Decorator' - filters: $prefix = $prefix . '_Filter' - validators: $prefix = $prefix . '_Validate'

Otherwise, the path prefix is set on the appropriate plugin loader.

Parameters
Name Type Description
$prefix string
$path string
$type string
Returns
Type Description
\Zend_Form_Element
Throws
Exception Description
\Zend_Form_Exception for invalid type
methodpublicaddValidator(string | \Zend_Validate_Interface $validator, bool $breakChainOnFailure = false, array $options = array()) : \Zend_Form_Element

Note: will overwrite existing validators if they are of the same class.

Parameters
Name Type Description
$validator string | \Zend_Validate_Interface
$breakChainOnFailure bool
$options array
Returns
Type Description
\Zend_Form_Element
Throws
Exception Description
\Zend_Form_Exception if invalid validator type
methodpublicfilterName(string $value, bool $allowBrackets = false) : string
Parameters
Name Type Description
$value string
$allowBrackets bool
Returns
Type Description
string
methodpublicgetAttrib(string $name) : string
Parameters
Name Type Description
$name string
Returns
Type Description
string
methodpublicgetConstraint(string $key) : mixed
Parameters
Name Type Description
$key string
Returns
Type Description
mixed
methodpublicgetConstraints() : array
Returns
Type Description
array
methodpublicgetCurrency() : string | null

Retrieve currency

Returns
Type Description
string | null
methodpublicgetDijitParam(string $key) : mixed
Parameters
Name Type Description
$key string
Returns
Type Description
mixed
methodpublicgetFractional() : bool

Get whether or not to present fractional values

Returns
Type Description
bool
methodpublicgetInvalidMessage() : string | null
Returns
Type Description
string | null
methodpublicgetLocale() : string | null
inherited

Retrieve locale

Inherited from: \Zend_Dojo_Form_Element_NumberTextBox::getLocale()
Returns
Type Description
string | null
methodpublicgetMaxLength() : int | null
Returns
Type Description
int | null
methodpublicgetMessages() : array

The array keys are validation failure message identifiers, and the array values are the corresponding human-readable message strings.

If isValid() was never called or if the most recent isValid() call returned true, then this method returns an empty array.

Returns
Type Description
array
methodpublicgetPattern() : string | null
inherited

Retrieve numeric format pattern

Inherited from: \Zend_Dojo_Form_Element_NumberTextBox::getPattern()
Returns
Type Description
string | null
methodpublicgetPlaces() : int | null
inherited

Retrieve decimal places

Inherited from: \Zend_Dojo_Form_Element_NumberTextBox::getPlaces()
Returns
Type Description
int | null
methodpublicgetPluginLoader(string $type) : \Zend_Loader_PluginLoader

Instantiates with default rules if none available for that type. Use 'decorator', 'filter', or 'validate' for $type.

Parameters
Name Type Description
$type string
Returns
Type Description
\Zend_Loader_PluginLoader
Throws
Exception Description
\Zend_Loader_Exception on invalid type.
methodpublicgetPromptMessage() : string | null
Returns
Type Description
string | null
methodpublicgetRegExp() : string | null
Returns
Type Description
string | null
methodpublicgetStrict() : bool
inherited

Retrieve strict flag

Inherited from: \Zend_Dojo_Form_Element_NumberTextBox::getStrict()
Returns
Type Description
bool
methodpublicgetSymbol() : string | null

Retrieve symbol

Returns
Type Description
string | null
methodpublicgetType() : string | null
inherited

Retrieve type

Inherited from: \Zend_Dojo_Form_Element_NumberTextBox::getType()
Returns
Type Description
string | null
methodpublicgetValidator(string $name) : \Zend_Validate_Interface | false
Parameters
Name Type Description
$name string
Returns
Type Description
\Zend_Validate_Interface | false False if not found, validator otherwise
methodpublichasConstraint(string $key) : bool
Parameters
Name Type Description
$key string
Returns
Type Description
bool
methodpublichasDijitParam(string $key) : bool
Parameters
Name Type Description
$key string
Returns
Type Description
bool
methodpublicisValid(mixed $value, mixed $context = null) : boolean

If a translation adapter is registered, any error messages will be translated according to the current locale, using the given error code; if no matching translation is found, the original message will be utilized.

Note: The filtered value is validated.

Parameters
Name Type Description
$value mixed
$context mixed
Returns
Type Description
boolean
Throws
Exception Description
\Zend_Validate_Exception If validation of $value is impossible
methodpublicremoveConstraint(string $key) : \Zend_Dojo_Form_Element_ValidationTextBox
Parameters
Name Type Description
$key string
Returns
Type Description
\Zend_Dojo_Form_Element_ValidationTextBox
methodpublicremoveValidator(string $name) : bool
Parameters
Name Type Description
$name string
Returns
Type Description
bool
methodpublicresolveElementId(\Zend_Form_Decorator_Interface $decorator) : string

Passed to the HtmlTag decorator as a callback in order to provide an ID.

Parameters
Name Type Description
$decorator \Zend_Form_Decorator_Interface
Returns
Type Description
string
methodpublicsetAllowEmpty(bool $flag) : \Zend_Form_Element

When the allow empty flag is enabled and the required flag is false, the element will validate with empty values.

Parameters
Name Type Description
$flag bool
Returns
Type Description
\Zend_Form_Element
methodpublicsetAttrib(string $name, mixed $value) : \Zend_Form_Element
Parameters
Name Type Description
$name string
$value mixed
Returns
Type Description
\Zend_Form_Element
Throws
Exception Description
\Zend_Form_Exception for invalid $name values
methodpublicsetConstraint(string $key, mixed $value) : \Zend_Dojo_Form_Element_ValidationTextBox
Parameters
Name Type Description
$key string
$value mixed
Returns
Type Description
\Zend_Dojo_Form_Element_ValidationTextBox
methodpublicsetConstraints(array $constraints) : \Zend_Dojo_Form_Element_ValidationTextBox

Refer to Dojo dijit.form.ValidationTextBox documentation for valid structure.

Parameters
Name Type Description
$constraints array
Returns
Type Description
\Zend_Dojo_Form_Element_ValidationTextBox
methodpublicsetCurrency(string $currency) : \Zend_Dojo_Form_Element_CurrencyTextBox

Set currency

Parameters
Name Type Description
$currency string
Returns
Type Description
\Zend_Dojo_Form_Element_CurrencyTextBox
methodpublicsetDijitParam(string $key, mixed $value) : \Zend_Dojo_Form_Element_Dijit
Parameters
Name Type Description
$key string
$value mixed
Returns
Type Description
\Zend_Dojo_Form_Element_Dijit
methodpublicsetErrorMessages(array $messages) : \Zend_Form_Element
Parameters
Name Type Description
$messages array
Returns
Type Description
\Zend_Form_Element
methodpublicsetErrors(array $messages) : \Zend_Form_Element
Parameters
Name Type Description
$messages array
Returns
Type Description
\Zend_Form_Element
methodpublicsetFilters(array $filters) : \Zend_Form_Element
Parameters
Name Type Description
$filters array
Returns
Type Description
\Zend_Form_Element
methodpublicsetFractional(bool $flag) : \Zend_Dojo_Form_Element_CurrencyTextBox

Set whether currency is fractional

Parameters
Name Type Description
$flag bool
Returns
Type Description
\Zend_Dojo_Form_Element_CurrencyTextBox
methodpublicsetIgnore(bool $flag) : \Zend_Form_Element
Parameters
Name Type Description
$flag bool
Returns
Type Description
\Zend_Form_Element
methodpublicsetInvalidMessage(string $message) : \Zend_Dojo_Form_Element_ValidationTextBox
Parameters
Name Type Description
$message string
Returns
Type Description
\Zend_Dojo_Form_Element_ValidationTextBox
methodpublicsetIsArray(bool $flag) : \Zend_Form_Element
Parameters
Name Type Description
$flag bool
Returns
Type Description
\Zend_Form_Element
methodpublicsetLocale(string $locale) : \Zend_Dojo_Form_Element_NumberTextBox
inherited

Set locale

Inherited from: \Zend_Dojo_Form_Element_NumberTextBox::setLocale()
Parameters
Name Type Description
$locale string
Returns
Type Description
\Zend_Dojo_Form_Element_NumberTextBox
methodpublicsetPattern(string $pattern) : \Zend_Dojo_Form_Element_NumberTextBox
inherited

Set numeric format pattern

Inherited from: \Zend_Dojo_Form_Element_NumberTextBox::setPattern()
Parameters
Name Type Description
$pattern string
Returns
Type Description
\Zend_Dojo_Form_Element_NumberTextBox
methodpublicsetPlaces(int $places) : \Zend_Dojo_Form_Element_NumberTextBox
inherited

Set decimal places

Inherited from: \Zend_Dojo_Form_Element_NumberTextBox::setPlaces()
Parameters
Name Type Description
$places int
Returns
Type Description
\Zend_Dojo_Form_Element_NumberTextBox
methodpublicsetPluginLoader(\Zend_Loader_PluginLoader_Interface $loader, string $type) : \Zend_Form_Element
Parameters
Name Type Description
$loader \Zend_Loader_PluginLoader_Interface
$type string

'decorator', 'filter', or 'validate'

Returns
Type Description
\Zend_Form_Element
Throws
Exception Description
\Zend_Form_Exception on invalid type
methodpublicsetPromptMessage(string $message) : \Zend_Dojo_Form_Element_ValidationTextBox
Parameters
Name Type Description
$message string
Returns
Type Description
\Zend_Dojo_Form_Element_ValidationTextBox
methodpublicsetRegExp(string $regexp) : \Zend_Dojo_Form_Element_ValidationTextBox
Parameters
Name Type Description
$regexp string
Returns
Type Description
\Zend_Dojo_Form_Element_ValidationTextBox
methodpublicsetStrict( $flag) : \Zend_Dojo_Form_Element_NumberTextBox
inherited

Set strict flag

Inherited from: \Zend_Dojo_Form_Element_NumberTextBox::setStrict()
Parameters
Name Type Description
$flag
Returns
Type Description
\Zend_Dojo_Form_Element_NumberTextBox
methodpublicsetSymbol(string $symbol) : \Zend_Dojo_Form_Element_CurrencyTextBox

Set currency symbol

Casts to string, uppercases, and trims to three characters.

Parameters
Name Type Description
$symbol string
Returns
Type Description
\Zend_Dojo_Form_Element_CurrencyTextBox
methodpublicsetType(string $type) : \Zend_Dojo_Form_Element_NumberTextBox
inherited

Set numeric format type

Inherited from: \Zend_Dojo_Form_Element_NumberTextBox::setType()
Parameters
Name Type Description
$type string
Returns
Type Description
\Zend_Dojo_Form_Element_NumberTextBox
Details
See
\global\$_allowedTypes  
methodpublicsetValidators(array $validators) : \Zend_Form_Element
Parameters
Name Type Description
$validators array
Returns
Type Description
\Zend_Form_Element
methodpublicsetView(\Zend_View_Interface $view = null) : \Zend_Dojo_Form_Element_Dijit

Ensures that the view object has the dojo view helper path set.

Parameters
Name Type Description
$view \Zend_View_Interface
Returns
Type Description
\Zend_Dojo_Form_Element_Dijit
Documentation was generated by phpDocumentor 2.0.0a8.