Latest releases of html_quickform2

HTML_QuickForm2 2.0.0

2012-06-26T16:24:10-05:00

* Leftover 'foo' no longer stays in grouped element's name when renaming group
named 'foo[foo]' (bug #19477)
* 'classes' property of qf.Validator moved to its prototype, making it easier
to override
* Items marked deprecated previously are removed

HTML_QuickForm2 2.0.0RC1

2012-05-22T19:18:02-05:00

Bug fixes
* Server-side validation errors for elements inside Repeats are properly
displayed
* Javascript for Repeat elements moved to a more proper qf.elements.Repeat
namespace, old qf.Repeat is kept as an alias but is deprecated
* Fixed markup in usage examples (related to bug #19097)
* Callback renderer now generates the same markup as Default renderer out of
the box, this addresses bug #19097 and allows correct behaviour of
client-side validation and Repeat elements

Changes
* HTML_QuickForm2::getValue() no longer returns values for internal form
fields (request #19403)
* It is no longer possible to set validation errors on hidden elements or
create Rules that set such errors, doing this will result in an Exception
* add() method of qf.elements.Repeat can accept an explicit index for a new
item, returns the index for added item
* Array Renderer: changes to buildCommonFields() make it easier to use by
Renderer plugins, arrays built for groups contain 'class' attribute

Backwards compatibility issues
* Items marked deprecated will be removed in release 2.0.0

HTML_QuickForm2 2.0.0beta2

2012-04-18T13:10:03-05:00

Feature additions
* Repeat element: given 'prototype' Container (either fieldset or group)
is repeated multiple times, with possibility to add / remove repeated items
via Javascript. Full support for validation of repeated items.
* JavascriptBuilder now has separate getSetupCode() and getValidator()
methods in addition to combined getFormJavascript()

Bug fixes
* Generated 'id' attributes no longer can start with numbers
* Group::setValue() works properly for a group containing checkboxes named 'foo[]'
* 'checked' attribute for a checkbox is removed if form has data sources and
none of them contains a value for that checkbox
* Explicitly given value="0" for a checkbox is not replaced by value="1"
* setValue(null) no longer causes value="value" in some elements
* Hierselect's value is properly updated when its name changes
* Unit tests use autoloader instead of explicit 'require_once', all tests now
can be run separately
* HTML_QuickForm2_Renderer::register() allows overriding an existing renderer
type, similar to elements and rules
* Frozen HTML for checkboxes and radios no longer uses tags * Fixed markup in controller/wizard.php and renderers/array-twig.php examples

HTML_QuickForm2 2.0.0beta1 2012-03-20T14:11:02-05:00 Feature additions * Added 'email' Rule (request #16906) * Added Stub Renderer which does minimal form processing. Useful for forms containing Javascript that are output manually. * It is easier to customize client-side validation: all methods of qf.Validator are public, CSS class names for validation status are kept in validator's property. * Test suite now properly runs from SVN checkout and under PHPUnit 3.6 * PHPDoc cleanup, added @method annotations to Container Bug fixes * Fixed running tests for elements separately (bug #19039) * Fixed errors removal in client-side validation (bug #19063) * IDs for autogenerated elements no longer start with underscores, default form output no longer contains empty tags (bug #19097) * HTML_QuickForm2_Controller_Action_Jump defaults to using $_SERVER['HTTP_HOST'] for host name (bug #19216) * Group::setValue() now properly allows fluent calls (bug #19307) * Container::validate() will now return false if any contained element has an error message set * Added abstract render() method to Node and abstract reset() to Renderer * DefaultAction element no longer contains invalid 'width' and 'height' attributes, 'src' attribute defaults to 'data:' URL * 'Live' client-side rules run only once on changing the form field, prevent errors when form HTML contains links Backwards compatibility issues * Items marked deprecated in version 0.6.0 are now removed HTML_QuickForm2 0.6.1 2011-09-29T12:49:37-05:00 Bug fixes * Callback renderer did not export setLabelCallback() method (bug #18833) * Trying to use Static element under PHP 5.2 resulted in fatal error (bug #18874) * persistentFreeze() is on by default for text and password elements Other features and changes * Added an example showing how to output the form with Twig template engine * Space characters are no longer allowed in 'id' attribute values (request #18683) * Added array type hinting to $data parameter in all elements' constructors * Fixed copypasted PHPDoc in several places HTML_QuickForm2 0.6.0 2011-06-13T19:03:26-05:00 Milestone 6: "live" validation, localization changes, moving to beta Major additions and changes * It is now possible to run client-side validation rules on changing the fields value / leaving the field (onchange / onblur) as well as on form submit (see request #5308) * Client-side validation errors are now displayed near the elements by default instead of in javascript alert() dialog. This is mostly similar to behaviour of old HTML_QuickForm_DHTMLRulesTableless package. * Localization messages (month and weekday names for Date, upload errors for InputFile) are now returned by special "message provider" object or callback (request #18341). A message provider for Date element using current locale data is available (request #5558) * Added a new optional renderer that uses PHP callbacks to render form elements Other features and changes * Static elements can now wrap their content in a given tag having element's attributes, e.g. or (see request #8626) * It is now possible to set maximum and minimum hour in Date element's hours select (request #4061, works for 24-hour format) and maximum and minimum month in its months select (request #5957) * File upload elements can no longer be added to method="get" forms, form's enctype attribute is automatically set (request #16807) * Added a separate HTML_QuickForm2::isSubmitted() method, can be used to check whether the form was sumbitted instead of checking an array of its data sources for submit one * Added HTML_QuickForm2_Renderer::methodExists() method, this can be used to check whether a custom renderer has a necessary method / plugin and fall back to the Default renderer if it doesn't * Added default 'value' attribute for radiobuttons * Array renderer always returns group separator as an array of length count($group) - 1, making it easier to use in templates * Added CLIENT_SERVER and ONBLUR_CLIENT_SERVER constants to HTML_QuickForm2_Rule, these make calls to addRule() less verbose * Minified versions of javascript libraries are now provided Bug fixes * Unit tests can now run under PHPUnit 3.5 * Required rule will throw an Exception if not given an error message (bug #18133) * Default maxYear in Date element is now current year rather than 2010 (bug #18171) * Group::removeChild() failed if group's name contained brackets (bug #18182) * Values for elements named like 'foo[]' are now properly handled by getValue() Backwards compatibility issues * Javascript libraries are now installed into js/ and js/min/ subdirectories of base data directory * 'errorMessages' parameter for HTML_QuickForm2_Element_InputFile is deprecated and will be removed in the next release. Use message providers HTML_QuickForm2 0.5.0 2010-12-09T09:22:24-05:00 Milestone 5: Javascript support, client-side validation, filters Major additions and changes * It is now possible to run validation rules client-side as well as server-side. This is controlled by passing a parameter to addRule() * Implemented client-side validation for most builtin rules (MaxFileSize and MimeType rules for file uploads cannot work client-side) * Added JavascriptBuilder class, an instance of that is stored in Renderer and aggregates client-side rules, references to Javascript library files and Javascript for elements' initialization. Inline Javascript can be easily added with a special Script element * Implemented base Javascript library to support client-side validation. It should hopefully allow easier customization than inline Javascript in HTML_QuickForm 3.x * Implemented addFilter() and addRecursiveFilter() methods which can be used to (recursively) apply filter callbacks to element values when calling getValue(). A new getRawValue() method allows getting unfiltered values. Other features and changes * Ported Date element from HTML_QuickForm 3.x * Ported Hierselect element from HTML_QuickForm 3.x, it can now use callbacks to load additional options via AJAX (see enclosed hierselect-ajax.php example) * Ported Static element from HTML_QuickForm 3.x * Added HTML_QuickForm2_Node::getData() method * Added NotCallback and NotRegex rules, they consider element valid if callback returns false for its value / if the value does not match regex, respectively * It is now possible for autogenerated 'id' attributes to not have mandatory indexes appended. Use HTML_Common2::setOption('id_force_append_index', false); * Container rules are called after rules on contained elements (request #17576) Bug fixes * Added a div around form elements to prevent generating invalid HTML (bug #17217) * Fixed counterintuitive behaviour of DataSource_Array (reported by Cedrick Gout in pear-general mailing list) Backwards compatibility issues * Methods marked as deprecated in release 0.4.0 are now removed HTML_QuickForm2 0.4.0 2010-03-08T15:31:27-05:00 Milestone 4: port of HTML_QuickForm_Controller, group rules Major additions and changes * Includes a port of HTML_QuickForm_Controller. It is now possible to create multipage forms (wizards, tabbed forms, etc.) with HTML_QuickForm2 * It is now possible to leverage existing rules for group validation (see also request #12610) * Rule configuration redone, now an error for an incomplete or bogus configuration will be thrown immediately on adding a Rule rather than on validating with it. Rule::getConfig() will now return the complete configuration rather than a local part of it. Features added * It is possible to disable "intrinsic validation" for select elements (request #13088) * Checkboxes named 'foo[]' properly get their values from data sources (request #16806) * Arrays generated by Array Renderer for fieldsets and groups contain 'type' keys (request #16937) * Added setElementTemplateForGroupClass() and setElementTemplateForGroupId() methods HTML_QuickForm2_Renderer_Default setting templates for grouped elements within a group of a given class or with a given id, respectively Bug fixes * E_NOTICE for an undefined index could be emitted when outputting a checkbox (bug #16816) Backwards compatibility issues * HTML_QuickForm2_Renderer_Default::setGroupedTemplateForClass() is deprecated * If you implemented custom Rules, you should rewrite them to conform to the new Rule configuration approach (this may require implementing custom mergeConfig() and setConfig() methods) and implement validateOwner() method instead of checkValue(). Old-style Rules will emit notices in 0.4.0 and will stop working completely in the next release. * Packaging changes: data/, docs/ and tests/ contents are installed without redundant subdirectories, e.g. quickform.css now resides in @data_dir@/HTML_QuickForm2 rather than @data_dir@/HTML_QuickForm2/data HTML_QuickForm2 0.3.0 2009-10-25T19:18:56-05:00 Milestone 3: renderers and groups Major additions and changes * Renderers implemented, Default and Array renderers ported from QuickForm 3.x * Groups implemented Feature requests addressed: * Default rendering without tables (request #9116) * setSeparator() method (request #9942) Bug fixes: * Updated PHP dependency to 5.2.0 (bug #14110, PHP bug #37632) * 'checked' attributed on checkboxes and radios was not updated after changing 'value' attribute (bug #15708) Deprecated features: * setOptions() and getOptions() methods of HTML_QuickForm2_Rule are deprecated and will be removed in the next release. Use setConfig() and getConfig() instead. WARNING: next release will have backwards compatibility breaks in setting Rule configuration data. If you are just using built-in Rules you should not be affected, but if you wrote custom subclasses for HTML_QuickForm2_Rule then pay special attention to changes in SVN. HTML_QuickForm2 0.2.0 2007-10-22T12:13:24-05:00 Milestone 2: now with server-side validation support Major additions and changes: * Server-side validation support added * API break: changed number and order of parameters for element constructors * Fluent interfaces: methods that previously returned nothing now return $this * Added method overloading to Container, allowing $form->addTextarea(...) Feature requests addressed: * Possibility to control validation of an element based on value of some other element (request #4534) * Rule comparing value of an element with numeric constants (request #4728) * Possibility to toggle validation of empty elements (request #9097) Bug fixes (bugs submitted for HTML_QuickForm package): * Wrong options could be selected in