html::formhandler::field::upload(3pm) [debian man page]

HTML::FormHandler::Field::Upload(3pm)			User Contributed Perl Documentation		     HTML::FormHandler::Field::Upload(3pm)

NAME

       HTML::FormHandler::Field::Upload - file upload field

VERSION

       version 0.40013

DESCRIPTION

       This field is designed to be used with a blessed object with a 'size' method, such as Catalyst::Request::Upload, or a filehandle.
       Validates that the file is not empty and is within the 'min_size' and 'max_size' limits (limits are in bytes).  A form containing this
       field must have the enctype set.

	   package My::Form::Upload;
	   use HTML::FormHandler::Moose;
	   extends 'HTML::FormHandler';

	   has '+enctype' => ( default => 'multipart/form-data');

	   has_field 'file' => ( type => 'Upload', max_size => '2000000' );
	   has_field 'submit' => ( type => 'Submit', value => 'Upload' );

       In your controller:

	   my $form = My::Form::Upload->new;
	   my @params = ( file => $c->req->upload('file') )
		    if $c->req->method eq 'POST';
	   $form->process( params => { @params } );
	   return unless ( $form->validated );

       You can set the min_size and max_size limits to undef if you don't want them to be validated.

DEPENDENCIES

   widget
       Widget type is 'upload'

AUTHOR

       FormHandler Contributors - see HTML::FormHandler

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 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.

perl v5.14.2							    2012-06-25				     HTML::FormHandler::Field::Upload(3pm)

HTML::FormHandler::Field::Display(3pm)			User Contributed Perl Documentation		    HTML::FormHandler::Field::Display(3pm)

NAME

       HTML::FormHandler::Field::Display - display only field

VERSION

       version 0.40013

SYNOPSIS

       This class can be used for fields that are display only. It will render the value returned by a form's 'html_<field_name>' method, or the
       field's 'html' attribute.

	 has_field 'explanation' => ( type => 'Display',
	    html => '<p>This is an explanation...</p>' );

       or in a form:

	 has_field 'explanation' => ( type => 'Display' );
	 sub html_explanation {
	    my ( $self, $field ) = @_;
	    if( $self->something ) {
	       return '<p>This type of explanation...</p>';
	    }
	    else {
	       return '<p>Another type of explanation...</p>';
	    }
	 }
	 #----
	 has_field 'username' => ( type => 'Display' );
	 sub html_username {
	     my ( $self, $field ) = @_;
	     return '<div><b>User:&nbsp;</b>' . $field->value . '</div>';
	 }

       or set the name of the rendering method:

	  has_field 'explanation' => ( type => 'Display', set_html => 'my_explanation' );
	  sub my_explanation {
	    ....
	  }

       You can also supply an 'html' method with a trait or a custom field. See examples in t/field_traits.t and t/xt/display.t of the
       distribution.

AUTHOR

       FormHandler Contributors - see HTML::FormHandler

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 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.

perl v5.14.2							    2012-06-25				    HTML::FormHandler::Field::Display(3pm)