/ 
HTML-FormHandler-0.33002
River stage two • 21 direct dependents • 31 total dependents
/ HTML::FormHandler::Field::Repeatable

NAME

HTML::FormHandler::Field::Repeatable - repeatable (array) field

VERSION

version 0.33002

SYNOPSIS

In a form, for an array of hashrefs, equivalent to a 'has_many' database relationship.

has_field 'addresses' => ( type => 'Repeatable' );
has_field 'addresses.address_id' => ( type => 'PrimaryKey' );
has_field 'addresses.street';
has_field 'addresses.city';
has_field 'addresses.state';

In a form, for an array of single fields (not directly equivalent to a database relationship) use the 'contains' pseudo field name:

has_field 'tags' => ( type => 'Repeatable' );
has_field 'tags.contains' => ( type => 'Text',
     apply => [ { check => ['perl', 'programming', 'linux', 'internet'],
                  message => 'Not a valid tag' } ]
);

or use 'contains' with single fields which are compound fields:

has_field 'addresses' => ( type => 'Repeatable' );
has_field 'addresses.contains' => ( type => '+MyAddress' );

If the MyAddress field contains fields 'address_id', 'street', 'city', and 'state', then this syntax is functionally equivalent to the first method where the fields are declared with dots ('addresses.city');

DESCRIPTION

This class represents an array. It can either be an array of hashrefs (compound fields) or an array of single fields.

The 'contains' keyword is used for elements that do not have names because they are not hash elements.

This field node will build arrays of fields from the the parameters or an initial object, or empty fields for an empty form.

The name of the element fields will be an array index, starting with 0. Therefore the first array element can be accessed with:

$form->field('tags')->field('0')
$form->field('addresses')->field('0)->field('city')

or using the shortcut form:

$form->field('tags.0')
$form->field('addresses.0.city')

The array of elements will be in $form->field('addresses')->fields. The subfields of the elements will be in a fields array in each element.

foreach my $element ( $form->field('addresses')->fields )
{
   foreach my $field ( $element->fields )
   {
      # do something
   }
}

Every field that has a 'fields' array will also have an 'error_fields' array containing references to the fields that contain errors.

Note that after updates to the database the fields will be reloaded. This means that the array indexes ( the '3' in $form->field('addresses.3') ) may not be the same if there have been changes since the fields were initially loaded.

ATTRIBUTES

index

This attribute contains the next index number available to create an additional array element.

num_when_empty

This attribute (default 1) indicates how many empty fields to present in an empty form which hasn't been filled from parameters or database rows.

AUTHOR

FormHandler Contributors - see HTML::FormHandler

COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by Gerda Shank.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.