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

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)