Index: lib/HTML/FormFu.pm
===================================================================
--- lib/HTML/FormFu.pm (revision 419)
+++ lib/HTML/FormFu.pm (working copy)
@@ -802,7 +802,7 @@
HTML::FormFu uses a templating system such as L
or L to create the form's XHTML output. As such, it needs
-to be able to find it's own template files. If you're using the L
+to be able to find its own template files. If you're using the L
web framework, just run the following command:
$ script/myapp_create.pl HTML::FormFu
@@ -815,9 +815,9 @@
running the following command (while in the directory containing your CGI
programs):
- $ html_formfu_deploy.pl
+ $ html_formfu_deploy.pl
-This installs the templates files in directory C<./root>, which is the
+This installs the template files in directory C<./root>, which is the
default path that HTML::FormFu searches in.
Although HTML::FormFu uses L internally,
@@ -860,7 +860,7 @@
The content of each config file is passed to L, and so are added
to the form.
-L may be called in a config file itself, as so allow
+L may be called in a config file itself, so as to allow
common settings to be kept in a single config file which may be loaded
by any form.
@@ -904,10 +904,10 @@
a value for that fieldname was submitted.
If L is set to a code-ref, it will be called as a subroutine
-with the two arguments C<$form> and C<$query>, and it's return value will be
+with the two arguments C<$form> and C<$query>, and its return value will be
used as the return value for L.
-If L is not set, will return true if a value for
+If L is not set, L will return true if a value for
any known fieldname was submitted.
=head2 auto_fieldset
@@ -1003,7 +1003,7 @@
Because of this behaviour, if you want nested fieldsets you will have to add
-each nested fieldset directly to it's intended parent.
+each nested fieldset directly to its intended parent.
my $parent = $form->get_element({ type => 'Fieldset' });
@@ -1038,7 +1038,7 @@
You can, of course, set L to any key in your L10N
file.
-=head1 force_error_message
+=head2 force_error_message
If true, forces the L to be displayed even if there are
no field errors.
@@ -1102,7 +1102,7 @@
- type: +MyApp::CustomElement
name: foo
-If a C is not provided in the C<\%options>, the default C will
+If a C is not provided in the C<\%options>, the default C will
be used.
L is an alias for L.
@@ -1181,7 +1181,7 @@
can be sure that all values have successfully passed all Constraints and have
been successfully passed through all Inflators. It is expected that most
Validators will be application-specific, and so each will be implemented as
-a seperate class written by the HTML::FormFu user.
+a separate class written by the HTML::FormFu user.
=head2 filters
@@ -1204,9 +1204,6 @@
See L for a list of core filters.
-If a C attribute isn't provided, a new filter is created for and
-added to every field on the form.
-
If you want to load a filter in a namespace other than
C, you can use a fully qualified package-name by
prefixing it with C<+>.
@@ -1352,7 +1349,7 @@
=head2 attrs_xml
-Provides the same functionality as L<"/attributes">, but values won't be
+Provides the same functionality as L, but values won't be
XML-escaped.
L is an alias for L.
@@ -1372,8 +1369,9 @@
$form->add_attributes( $key => $value );
$form->add_attributes( { $key => $value } );
-All values are appended to existing values, with a preceeding space
-character. This is primarily to allow the easy addition of new class names.
+All values are appended to existing values, with a preceding space
+character. This is primarily to allow the easy addition of new names to the class
+attribute.
$form->attributes({ class => 'foo' });
@@ -1387,7 +1385,7 @@
=head2 add_attrs_xml
-Provides the same functionality as L<"/add_attributes">, but values won't be
+Provides the same functionality as L, but values won't be
XML-escaped.
L is an alias for L.
@@ -1421,12 +1419,12 @@
=head2 del_attrs_xml
-Provides the same functionality as L<"/del_attributes">, but values won't be
+Provides the same functionality as L, but values won't be
XML-escaped.
L is an alias for L.
-The following methods are shortcuts for accessing L<"/attributes"> keys.
+The following methods are shortcuts for accessing L keys.
=head2 id
@@ -1728,7 +1726,7 @@
A (readonly) L compatible method.
-If a field name if given, in list-context returns any valid values submitted
+If a field name is given, in list-context returns any valid values submitted
for that field, and in scalar-context returns only the first of any valid
values submitted for that field.
@@ -1903,7 +1901,7 @@
Accepts a hash-ref of arguments passed to the render object constructor for
the form and all elements.
-The default render class (L) passes these
+The default render class (L) passes these
arguments to the L constructor.
The keys C and C are overridden to always be true, as
@@ -1944,6 +1942,7 @@
Return Value: \@elements
Returns all top-level elements in the form (not recursive).
+See L for a recursive version.
Accepts both C and C arguments to narrow the returned results.
@@ -1952,8 +1951,6 @@
type => 'Radio',
});
-See L for a recursive version.
-
=head2 get_element
Arguments: [%options]
@@ -1967,6 +1964,8 @@
=head2 get_all_elements
+=head2 get_all_element
+
=head2 get_fields
Arguments: [%options]
@@ -2194,7 +2193,7 @@
perl examples/vertically-aligned/vertically-aligned.pl
-This uses the C file C,
+This uses the L file C,
and the CSS is defined in files C and
C.
@@ -2257,13 +2256,13 @@
- type: Regex
common: [ URI, HTTP, { '-scheme': 'ftp|https?' ]
-=head2 If a user enters a value like " foo " and we need to redisplay the form, I would like the prefilled value to be "foo".
+=head2 If a user enters a value like " foo " and we need to redisplay the form, I would like the pre-filled value to be "foo".
First you have to use the TrimEdges Filter.
Second to get this behaviour, set 'render_processed_value' to a true value.
-You can set this at the form level to effect all fields, or set it at
+You can set this at the form level to affect all fields, or set it at
the fieldset- or field-level.
One thing to beware is if you have Inflators on a field that create an
Index: lib/HTML/FormFu/Element/Date.pm
===================================================================
--- lib/HTML/FormFu/Element/Date.pm (revision 419)
+++ lib/HTML/FormFu/Element/Date.pm (working copy)
@@ -355,9 +355,19 @@
---
elements:
- type: Date
- name: foo
+ name: birthdate
+ label: 'Birthdate:'
+ day:
+ prefix: "- Day -"
+ month:
+ prefix: "- Month -"
+ year:
+ prefix: "- Year -"
+ less: 70
+ plus: 0
auto_inflate: 1
+
=head1 DESCRIPTION
Creates a L element containing 3 select