All notable changes to this project will be documented in this file, in reverse chronological order by release.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- #235 fixes PHP 7.4 compatibility.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
-
#232 fixes validating
$creationOptionofZend\Form\ElementFactory. Allowed values are: array, Traversable or null. If invalid value provided exception will be thrown. -
#234 registers
SearchandTelform elements withinZend\Form\FormElementManagerplugin manager.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- #230 fixes the "
__clonemethod called on non-object" error that happens when the$targetElementisnullwithin aCollectioninstance. It now properly sets the data to an empty array in such circumstances.
- #228 adds support for PHP 7.3.
- Nothing.
- Nothing.
- #228 removes support for zend-stdlib v2 releases.
- Nothing.
-
#224 adds support for zend-hydrator v3 releases, while keeping support for versions 1 and 2.
-
#211 adds support for the HTML5
minlengthattribute in all form elements that support it. -
#217 adds
Zend\Form\View\HelperTrait, which can be used to provide IDE autocompletion for view helpers provided by zend-form. See https://docs.zendframework.com/zend-form/view-helpers/#ide-auto-completion-in-templates for more information.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
-
#218 ensures object values of select elements can be rendered without error.
-
#216 fixes an issue when performing data binding and a fieldset has no mapped input elements, casting
nullvalues to empty arrays to ensure they can be passed to an input filter. -
#207 fixes the return value annotation for the
Fieldset::get()method to indicate it can also return aFieldsetInterfaceinstance.
-
#194 adds the ability to whitelist additional HTML attributes for use with a view helper, as well as attribute prefixes. These can be enabled via the following:
$helper->addValidAttribute('attribute-name'); $helper->addValidAttributePrefix('prefix-');
-
#188 adds a new method to the
FormElementErrorsview helper,setTranslateMessages(bool $flag). By default, the helper continues to translate error messages (if a translator is present), as introduced in 2.11.0. However, using this method, you can disable translation, which may be necessary to prevent double translation and/or to reduce logs from missed translation lookups. Because the method implements a fluent interface, you may do so in one line:echo $this->formElementErrors()->setTranslateMessages(false);
Note: you will need to reset the value afterwards if you want translations to occur in later invocations.
- #193 modifies how attributes are escaped. If zend-espaper raises an exception for an invalid attribute value, helpers will now catch the exception, and use a blank value for the attribute. This prevents 500 errors from being raised for such pages.
- Nothing.
- Nothing.
- Nothing.
-
#104 adds the ability for the
FormElementErrorsview helper to translate validation error messages using the composed translator and text domain instances.
- Nothing.
- Nothing.
-
#162 fixes an issue with hydration when a form has called
setWrapElements(true), ensuring that binding values in a fieldset will correctly identify the elements in the provided data. -
#172 fixes the
DateTimeelement such that it no longer attempts to use itsDATETIME_FORMATconstant, but, rather, the value of the$formatproperty, when representing the element; this change allows developers to override the format, which was the original intention. -
#178 loosens the checks in
Zend\Form\Element\DateTime::getValue()to check against PHP'sDateTimeInterface(vsDateTime) when retrieving the value; this fixes edge cases where it was instead returning the format forDateTimeImmutablevalues.
- Nothing.
- Nothing.
- Nothing.
- #161 adds an import
statement to the
ElementFactory, fixing an error whereby checks forTraversablecreation options would lead to a service creation exception; these now correctly identify traversable options and convert them to an array. - #164 fixes how the
FormElementManagerFactoryfactory initializes the plugin manager instance, ensuring it is injecting the relevant configuration from theconfigservice and thus seeding it with configured form/form element services. This means that theform_elementsconfiguration will now be honored in non-zend-mvc contexts. - #159 fixes the behavior
of the
minandmaxattributes of the variousDateTimeelements, ensuring that the elements raise an exception during instantiation if the values provided are in a format thatDateTimedoes not recognize for the element type in question.
- Nothing.
- Nothing.
- Nothing.
- #134 fixes how the
FormElementManagerhandles invokable classes when theautoAddInvokableClassflag is enabled. Previously, it used the built-in utilities from zend-servicemanager, but now correctly uses its ownsetInvokableClass()method, which forces usage of theElementFactoryfor such classes, and thus ensures the name and options are passed to the element constructor. - #136 fixes how error
messages are provided when an element uses a required
ArrayInput, but no values are submitted. Previously, no messages were returned; now they are. - #156 fixes how elements
that act as
InputProviders are merged into parentCollectionInputFilters; previously, forms did not check if the element was in the target input filter composed in aCollectionInputFilter, leading to duplicate elements with varying behavior; now the inputs are correctly merged.
- #115 adds translatable HTML attributes to the abstract view helper.
- #116 adds the InputFilterFactory dependency to the constructor.
- Nothing.
- Nothing.
- #139 adds support for ReCaptcha version 2 though zend-captcha 2.7.1.
- #115 adds translatable HTML attributes to the abstract view helper.
- #116 adds the InputFilterFactory dependency to the constructor.
- Nothing.
- Nothing.
- #139 adds support for ReCaptcha version 2 though zend-captcha 2.7.1.
- Nothing.
- Nothing.
- Nothing.
- #122 fixes collection binding following successful validation. The fix introduced in #106, while it corrected the behavior around binding a collection that was not re-submitted, broke behavior around binding submitted collections. #122 corrects the issue, retaining the fix from #106.
- #85 adds support for the zend-code 3.0 series (retaining support for the 2.* series).
- Nothing.
- Nothing.
- #119 fixes the order in
which the default initializers are injected into the
FormElementManager, ensuring that the initializer injecting a factory into aFormFactoryAwareinstance is triggered before the initializer that callsinit(), and also that the initializer callinginit()is always triggered last. - #106 updates behavior around binding collection values to a fieldset or form such that if the collection is not part of the current validation group, its value will not be overwritten with an empty set.
- #57 adds new elements,
FormSearchandFormTel, which map to theFormSearchandFormTelview helpers.
- Nothing.
- Nothing.
- Updates the composer suggestions list to remove those that were redundant, and to add explicit constraints and reasons for each listed (e.g., zend-code is required for annotations support).
- #74 adds an
alias for the
FormTextareaview helper that is referenced in the documentation.
- Nothing.
- Nothing.
- #77 updates
Zend\Form\View\HelperConfigto improve performance when running under zend-servicemanager v3. - #19 provides a thorough fix for an issue when removing all items in a collection associated with a form. Prior to this release, values that existed in the collection persisted when a form submission intended to remove them.
- #70 adds and publishes the documentation to https://zendframework.github.io/zend-form/
- Nothing.
- Nothing.
- #69 fixes aliases in the
FormElementManagerpolyfill for zend-servicemanager v2 to ensure they are canonicalized correctly.
- #60 adds an alias from
Zend\Form\FormElementManagertoFormElementManagerin theConfigProvider. - #67 adds polyfills for
the
FormElementManagerto vary its definitions based on the major version of zend-servicemanager in use.FormElementManagerFactorywas updated to return the specific polyfill version, and an autoload rule was added to alias the class to the correct polyfill version. The polyfills were necessary to ensure that invokable classes are mapped to the newElementFactoryintroduced in the 2.7 series, thus ensuring instantiation is performed correctly.
- Nothing.
- Nothing.
- #65 fixes instantiation
of
Zend\Form\FormElementManagerto ensure that the default initializers,injectFactory()andcallElementInit()are registered as the first and last initializers, respectively, during construction, restoring the pre-2.7 behavior. - #67 fixes the behavior
of
Factory::create()to the pre-2.7.1 behavior of not passing creation options when retrieving an instance from theFormElementManager. This ensures that options are not passed to Element/Fieldset/Form instances until after they are fully initialized, ensuring that all dependencies are present.
- Nothing.
- Nothing.
- Nothing.
- #59 fixes the
Module::init()method to properly receive aModuleManagerinstance, and not expect aModuleEvent.
- #53 adds
Zend\Form\FormElementManagerFactory, for creating and returning instances ofZend\Form\FormElementManager. This factory was ported from zend-mvc, and will replace it for version 3 of that component. - #53 adds
Zend\Form\Annotation\AnnotationBuilderFactory, for creating and returning instances ofZend\Form\Annotation\AnnotationBuilder. This factory was ported from zend-mvc, and will replace it for version 3 of that component. - #53 exposes the package
as a config-provider and ZF component, by adding:
ConfigProvider, which maps theFormElementsManagerandFormAnnotationBuilderservies previously provided by zend-mvc; the form abstract factory as previously registered by zend-mvc; and all view helper configuration.Module, which maps services and view helpers per theConfigProvider, and provides configuration to the zend-modulemanagerServiceLocatorin order for modules to provide form and form element configuration.
- #53 deprecates
Zend\Form\View\HelperConfig; the functionality is made obsolete byConfigProvider. It now consumes the latter in order to provide view helper configuration.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- #24 ensures that when
Zend\Form\Form::getInputFilter()when lazy-creates anInputFilterinstance, it is populated with theInputFilterFactorypresent in its ownFormFactory. This ensures that any custom inputs, input filters, validators, or filters are available to the new instance. - #38 removes the arbitrary restriction of only the "labelledby" and "describedby" aria attributes on form element view helpers; any aria attribute is now allowed.
- #45 fixes the behavior
in
Zend\Form\Factory::create()when pulling elements from the form element manager; it now will pass specifications provided for the given element when calling the manager'sget()method.
- Nothing.
- Nothing.
- Nothing.
- #40 and
#43 prepare the
component to be forwards compatible with each of the following:
- zend-eventmanager v3
- zend-hydrator v2.1
- zend-servicemanager v3
- zend-stdlib v3
- #14 ensures that collections can remove all elements when populating values.
- #17 updates the component to use zend-hydrator for hydrator functionality; this provides forward compatibility with zend-hydrator, and backwards compatibility with hydrators from older versions of zend-stdlib.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- #16 updates the
zend-stdlib dependency to reference
>=2.5.0,<2.7.0to ensure hydrators will work as expected following extraction of hydrators to the zend-hydrator repository.
- Nothing.
- #12 deprecates the
AllowEmptyandContinueIfEmptyannotations, to mirror changes made in zend-inputfilter#26.
- Nothing.