NAME

Form::Toolkit::Form - A Moose base class for Form implementation

BUILD

Hooks in the Moose BUILD to call build_fields

fast_clone

Returns fast clone of this form. This is field value focused and as shallow as possible, so use with care if you want to change anything else than field values in your clones.

Benchmarking has shown this is 50x faster than the MooseX::Clone based clone method.

Usage:

 my $clone = $this->fast_clone();

id

Shortcut to $this->meta->id();

do_accept

Accepts a form visitor returns this visitor's visit_form method returned value.

Usage:

  my $result = $this->do_accept($visitor);

build_fields

Called after Form creation to add_field to $self.

This should be the method you need to implement in your subclasses.

Usage:

  sub build_fields{
    my ($self) = @_;
    $self->add_field('Date' , 'a_date_field');
    $self->add_field('String' , 'a string field');
    # etc..
  }

add_error

Adds an error to this form (as a string).

 $this->add_error('Something is globally wrong');

add_field

Usage:

   $this->add_field('field_name');
   $this->add_field('FieldType', 'field_name'); ## 'FieldType' is turned into Form::Toolkit::Field::FieldType'.
   $this->add_field($field_instance);

field

Get a field by name or undef.

Usage:

  my $field = $this->field('my_field');

is_valid

Opposite of has_errors.

has_errors

Returns true if this form has errors, false otherwise.

Usage:

  if( $this->has_errors() ){
    ...
  }

dump_errors

Convenience debugging method.

Returns

 { _form => [ 'error1' , ... ],
   field1 => [ 'error' , ... ],
   field2 => [ 'error' , ... ],
   ...
 }

reset

Alias for clear. please override clear if you want. Don't touch this.

clear

Resets this form to its void state. After the call, this form is ready to be used again.

values_hash

Returns a hash of values like that:

{ a => 'aaa', b => 'bbb', multiplea => [ v1 , v2 , v3 ], multipleb => [] }

You can feed this hash to the Form::Toolkit::Clerk::Hash got populate a similar form.

literal

Returns a litteral representation of this form (as a Base64 encoded JSON byte string).

Usage:

   print $this->litteral();

from_literal

Class or instance method. Builds a new instance of form from the given litteral (See litteral).

If you are using Forms as other Form's field values, and if all your forms require extra attribute, you can override that IN YOUR CONTAINER form. It will be called as an instance method by the form filling Clerks. See example in test 11.

Usage:

  my $form = $this->from_literal($litteral);

fill_hash

Shortcut to fill this form with a pure Perl hash. After calling this, the form will be validated and populated with error messages if necessary.

Usage:

 $this->fill_hash({ field1 => 'value' , field2 => undef , field3 => [ 'a' , 'b' , 'c' ]});

 $this->fill_hash($another_form->values_hash());

 if( $this->has_errors() ){

 }

cpanm Form::Toolkit

perl -MCPAN -e shell
install Form::Toolkit