Zend Framework » \Zend\Form\View\Helper\FormSelect

Base functionality for all form view helpers

Methods

Invoke helper as functor

__invoke(\Zend\Form\ElementInterface $element) : string | \Zend\Form\View\Helper\FormSelect

Proxies to render().

Parameters

$element

\Zend\Form\ElementInterfacenull

Returns

string\Zend\Form\View\Helper\FormSelect

Create a string of all attribute/value pairs

createAttributesString(array $attributes) : string

Inherited

Escapes all attribute values

inherited_from	\Zend\Form\View\Helper\AbstractHelper::createAttributesString()

Parameters

$attributes

array

Returns

string

Get value for doctype

getDoctype() : string

Inherited

inherited_from	\Zend\Form\View\Helper\AbstractHelper::getDoctype()

Returns

string

Get character encoding

getEncoding() : string

Inherited

inherited_from	\Zend\Form\View\Helper\AbstractHelper::getEncoding()

Returns

string

Get the ID of an element

getId(\Zend\Form\ElementInterface $element) : null | string

Inherited

If no ID attribute present, attempts to use the name attribute. If no name attribute is present, either, returns null.

inherited_from	\Zend\Form\View\Helper\AbstractHelper::getId()

Parameters

$element

\Zend\Form\ElementInterface

Returns

nullstring

Get the closing bracket for an inline tag

getInlineClosingBracket() : string

Inherited

Closes as either "/>" for XHTML doctypes or ">" otherwise.

inherited_from	\Zend\Form\View\Helper\AbstractHelper::getInlineClosingBracket()

Returns

string

Returns translator used in helper

getTranslator() : \Zend\I18n\Translator\TranslatorInterface | null

Inherited

inherited_from	\Zend\I18n\View\Helper\AbstractTranslatorHelper::getTranslator()
inherited_from	\Zend\Form\View\Helper\AbstractHelper::getTranslator()

Returns

\Zend\I18n\Translator\TranslatorInterfacenull

Return the translation text domain

getTranslatorTextDomain() : string

Inherited

inherited_from	\Zend\I18n\View\Helper\AbstractTranslatorHelper::getTranslatorTextDomain()
inherited_from	\Zend\Form\View\Helper\AbstractHelper::getTranslatorTextDomain()

Returns

string

Get the view object

getView() : null | \Zend\View\Renderer\RendererInterface

Inherited

inherited_from	\Zend\View\Helper\AbstractHelper::getView()
inherited_from	\Zend\I18n\View\Helper\AbstractTranslatorHelper::getView()
inherited_from	\Zend\Form\View\Helper\AbstractHelper::getView()

Returns

null\Zend\View\Renderer\RendererInterface

Checks if the helper has a translator

hasTranslator() : bool

Inherited

inherited_from	\Zend\I18n\View\Helper\AbstractTranslatorHelper::hasTranslator()
inherited_from	\Zend\Form\View\Helper\AbstractHelper::hasTranslator()

Returns

bool

Returns whether translator is enabled and should be used

isTranslatorEnabled() : bool

Inherited

inherited_from	\Zend\I18n\View\Helper\AbstractTranslatorHelper::isTranslatorEnabled()
inherited_from	\Zend\Form\View\Helper\AbstractHelper::isTranslatorEnabled()

Returns

bool

Render a form <select> element from the provided $element

render(\Zend\Form\ElementInterface $element) : string

Parameters

$element

\Zend\Form\ElementInterface

Exceptions

`\Zend\Form\Exception\InvalidArgumentException`
`\Zend\Form\Exception\DomainException`

Returns

string

Render an optgroup

renderOptgroup(array $optgroup, array $selectedOptions) : string

See renderOptions() for the options specification. Basically, an optgroup is simply an option that has an additional "options" key with an array following the specification for renderOptions().

Parameters

$optgroup

array

$selectedOptions

array

Returns

string

Render an array of options

renderOptions(array $options, array $selectedOptions) : string

Individual options should be of the form:

array(
    'value'    => 'value',
    'label'    => 'label',
    'disabled' => $booleanFlag,
    'selected' => $booleanFlag,
)

Parameters

$options

array

$selectedOptions

array

Option values that should be marked as selected

Returns

string

Set value for doctype

setDoctype(string $doctype) : \Zend\Form\View\Helper\AbstractHelper

Inherited

inherited_from	\Zend\Form\View\Helper\AbstractHelper::setDoctype()

Parameters

$doctype

string

Returns

\Zend\Form\View\Helper\AbstractHelper

Set value for character encoding

setEncoding(string $encoding) : \Zend\Form\View\Helper\AbstractHelper

Inherited

inherited_from	\Zend\Form\View\Helper\AbstractHelper::setEncoding()

Parameters

$encoding

string

Returns

\Zend\Form\View\Helper\AbstractHelper

Sets translator to use in helper

setTranslator(\Zend\I18n\Translator\TranslatorInterface $translator, string $textDomain) : \Zend\I18n\View\Helper\AbstractTranslatorHelper

Inherited

inherited_from	\Zend\I18n\View\Helper\AbstractTranslatorHelper::setTranslator()
inherited_from	\Zend\Form\View\Helper\AbstractHelper::setTranslator()

Parameters

$translator

\Zend\I18n\Translator\TranslatorInterface

[optional] translator. Default is null, which sets no translator.

$textDomain

string

[optional] text domain Default is null, which skips setTranslatorTextDomain

Returns

\Zend\I18n\View\Helper\AbstractTranslatorHelper

Sets whether translator is enabled and should be used

setTranslatorEnabled(bool $enabled) : \Zend\I18n\View\Helper\AbstractTranslatorHelper

Inherited

inherited_from	\Zend\I18n\View\Helper\AbstractTranslatorHelper::setTranslatorEnabled()
inherited_from	\Zend\Form\View\Helper\AbstractHelper::setTranslatorEnabled()

Parameters

$enabled

bool

Returns

\Zend\I18n\View\Helper\AbstractTranslatorHelper

Set translation text domain

setTranslatorTextDomain(string $textDomain) : \Zend\I18n\View\Helper\AbstractTranslatorHelper

Inherited

inherited_from	\Zend\I18n\View\Helper\AbstractTranslatorHelper::setTranslatorTextDomain()
inherited_from	\Zend\Form\View\Helper\AbstractHelper::setTranslatorTextDomain()

Parameters

$textDomain

string

Returns

\Zend\I18n\View\Helper\AbstractTranslatorHelper

Set the View object

setView(\Zend\View\Renderer\RendererInterface $view) : \Zend\View\Helper\AbstractHelper

Inherited

inherited_from	\Zend\View\Helper\AbstractHelper::setView()
inherited_from	\Zend\I18n\View\Helper\AbstractTranslatorHelper::setView()
inherited_from	\Zend\Form\View\Helper\AbstractHelper::setView()

Parameters

$view

\Zend\View\Renderer\RendererInterface

Returns

\Zend\View\Helper\AbstractHelper

Retrieve the doctype helper

getDoctypeHelper() : \Zend\View\Helper\Doctype

Inherited

inherited_from	\Zend\Form\View\Helper\AbstractHelper::getDoctypeHelper()

Returns

\Zend\View\Helper\Doctype

Retrieve the escapeHtmlAttr helper

getEscapeHtmlAttrHelper() : \Zend\View\Helper\EscapeHtmlAttr

Inherited

inherited_from	\Zend\Form\View\Helper\AbstractHelper::getEscapeHtmlAttrHelper()

Returns

\Zend\View\Helper\EscapeHtmlAttr

Retrieve the escapeHtml helper

getEscapeHtmlHelper() : \Zend\View\Helper\EscapeHtml

Inherited

inherited_from	\Zend\Form\View\Helper\AbstractHelper::getEscapeHtmlHelper()

Returns

\Zend\View\Helper\EscapeHtml

getFormHiddenHelper()

getFormHiddenHelper() : \Zend\Form\View\Helper\FormHidden

Returns

\Zend\Form\View\Helper\FormHidden

Prepare attributes for rendering

prepareAttributes(array $attributes) : array

Inherited

Ensures appropriate attributes are present (e.g., if "name" is present, but no "id", sets the latter to the former).

Removes any invalid attributes

inherited_from	\Zend\Form\View\Helper\AbstractHelper::prepareAttributes()

Parameters

$attributes

array

Returns

array

Prepare a boolean attribute value

prepareBooleanAttributeValue(string $attribute, mixed $value) : string

Inherited

Prepares the expected representation for the boolean attribute specified.

inherited_from	\Zend\Form\View\Helper\AbstractHelper::prepareBooleanAttributeValue()

Parameters

$attribute

string

$value

mixed

Returns

string

renderHiddenElement()

renderHiddenElement(\Zend\Form\ElementInterface $element)

Parameters

$element

Ensure that the value is set appropriately

validateMultiValue(mixed $value, array $attributes) : array

If the element's value attribute is an array, but there is no multiple attribute, or that attribute does not evaluate to true, then we have a domain issue -- you cannot have multiple options selected unless the multiple attribute is present and enabled.

Parameters

$value

mixed

$attributes

array

Exceptions

`\Zend\Form\Exception\DomainException`

Returns

array

Properties

Standard boolean attributes, with expected values for enabling/disabling

$booleanAttributes : array

Inherited

inherited_from	\Zend\Form\View\Helper\AbstractHelper::$$booleanAttributes

$doctypeHelper

$doctypeHelper : \Zend\View\Helper\Doctype

Inherited

inherited_from	\Zend\Form\View\Helper\AbstractHelper::$$doctypeHelper

$escapeHtmlAttrHelper

$escapeHtmlAttrHelper : \Zend\View\Helper\EscapeHtmlAttr

Inherited

inherited_from	\Zend\Form\View\Helper\AbstractHelper::$$escapeHtmlAttrHelper

$escapeHtmlHelper

$escapeHtmlHelper : \Zend\View\Helper\EscapeHtml

Inherited

inherited_from	\Zend\Form\View\Helper\AbstractHelper::$$escapeHtmlHelper

$formHiddenHelper

$formHiddenHelper : \Zend\Form\View\Helper\FormHidden | null

Translatable attributes

$translatableAttributes : array

Translator (optional)

$translator : \Zend\I18n\Translator\TranslatorInterface

Inherited

inherited_from	\Zend\I18n\View\Helper\AbstractTranslatorHelper::$$translator
inherited_from	\Zend\Form\View\Helper\AbstractHelper::$$translator

Whether translator should be used

$translatorEnabled : bool

Inherited

inherited_from	\Zend\I18n\View\Helper\AbstractTranslatorHelper::$$translatorEnabled
inherited_from	\Zend\Form\View\Helper\AbstractHelper::$$translatorEnabled

Translator text domain (optional)

$translatorTextDomain : string

Inherited

inherited_from	\Zend\I18n\View\Helper\AbstractTranslatorHelper::$$translatorTextDomain
inherited_from	\Zend\Form\View\Helper\AbstractHelper::$$translatorTextDomain

Attributes globally valid for all tags

$validGlobalAttributes : array

Inherited

inherited_from	\Zend\Form\View\Helper\AbstractHelper::$$validGlobalAttributes

Attributes valid for option groups

$validOptgroupAttributes : array

Attributes valid for options

$validOptionAttributes : array

Attributes valid for select

$validSelectAttributes : array

Attributes valid for the current tag

$validTagAttributes : array

Will vary based on whether a select, option, or optgroup is being rendered

View object instance

$view : \Zend\View\Renderer\RendererInterface

Inherited

inherited_from	\Zend\View\Helper\AbstractHelper::$$view
inherited_from	\Zend\I18n\View\Helper\AbstractTranslatorHelper::$$view
inherited_from	\Zend\Form\View\Helper\AbstractHelper::$$view